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1. INTRODUCTION 

The Wunderbuss Input/Output Controller (WB I/O) is the heart of a 
general purpose S-100 system that combines all the features 
necessary for an efficient interriipt-driven, multi-user system. 
The WB I/O is built on a motherboard capable of holding up to 14 
additional S-100 utility cards. Its features include: 

1. A patented active termination system that reduces noise 
inherent to connection of S-100 signal lines. 

2. An 8259-A Programmable Interrupt Controller (PIC) device 
designed to monitor up to eight peripheral devices and 
set priorities for their service. 

3. Three 40-pin programmable Asynchronous Communication Elements 
(8250 ACE serial interfacing devices) capable of generating 
CPU interrupts in response to RS 232 signals and communica- 
tion events. 

4. A 50-pin connector for a daisy-wheel printer. 

5. A bi-directional, undedicated, multi-purpose parallel port. 

6. A CMOS crystal-controlled, multi-functional calendar/clock 
chip. 

The serial, parallel, clock and PIC devices on the WB I/O are all 
I/O mapped. They are accessed through switch selectable I/O port 
addresses. These devices may be programmed to generate interrupts 
to the CPU via the PIC based on a rich selection of status 
conditions. 

The design and versatility of the WB I/O ensures the user of a 
long useful life, even in a system subject to frequent upgrading. 
Like all Morrow Design products, it should give the user years of 
satisfaction. 



2. WB I/O ACTIVE TERMINATION 

The WB I/O features a 14 slot IEEE 696 standard S-100 motherboard 
with a patented active termination system referred to as Noise 
Guard. The structure and pinout of the S-100 bus normally lends 
itself to crosstalk and signal noise in an inproperly or 
unterminated bus. But the WB I/O eliminates this problem by the 
use of active termination. All IEEE 696 signal lines are actively 
pulled up through 180 Ohm resistors. One exception to this is 
PRESET, line 75. This line is pulled high on the MPZ80 CPU card. 
The table below depicts the power connections for the S-100 pins. 

Table 2-1: S-100 Power Connections 

Pins Connection 

1,51 + 8 V unregulated 

2 + 16 V unregulated 

52 - 16 V unregulated 

20 ground 

50 ground 

70 ground 

100 ground 

The design of the WBI /0 motherboard allows the bus to meet or 
exceed all the specifications for the S-100 bus at 6 Mhz making 
the board the heart of a powerful, reliable and expandable sys- 
tem. For a complete description of the S-100 bus, refer to the 
reference on specifications for the S-100 bus interface devices. 

3. I/O ADDRESSING 

All devices on the WB I/O are associated with some S-100 I/O 
port. In all, almost 30 distinct I/O registers are used to 
control the many device functions available on the board. Yet 
the WB I/O takes up only eight I/O port addresses. To understand 
how so many registers can be accessed through so few ports, it is 
useful to think of the port addressing scheme of the WB I/O as 
'bank-select I/O'. As the name suggests, this is analogous to 
conventional bank-select memory schemes. Specifically, banks of 
registers are allowed to share the same block of consecutive I/O 
addresses while a dedicated I/O port is used to enable one bank, 
and at the same time, disable all other similarly addressed 
banks . 



The WB I/O is divided into four I/O banks, (hereafter called 
groups) with each group occupying the same eight I/O port 
addresses - BASE to BASE+7. Port address BASE+7 is the GROUP 
SELECT port, and establishes which of the four I/O groups will be 
active at any given time. By outputting some number between 
and 3 to the GROUP SELECT port the user enables operations direc- 
ted to ports between BASE and BASE+6. To enable a different 
group, the user must output a different group number to GROUP 
SELECT port BASE+7. While this port selection technique is 
extremely efficient in conserving I/O space, it does impose the 
responsibility of keeping track of which I/O group is currently 
active. 

3.1. I/O Port Addressing 

DIP switch 7C is used to determine the BASE port address of the 
I/O groups on the WB I/O. Paddles 2 through 6 of switch 7C are 
compared with S-100 address lines A3 through A7 allowing BASE to 
be located at any eight byte I/O boundary. The relationship 
between the the paddles and the address lines are as follows: 

Table 3-1: DIP Switch 7C 



Paddle Number Address Line 

2 A7 

3 A6 

4 A5 

5 A4 

6 A3 



Setting a paddle to the ON position causes a match to occur when 
its associated address line is a low logic level. If all five 
switches are ON, the BASE address is at port 0. The standard 
address in all Morrow Design systems is port 48 hex. 

3.2. GROUP SELECT Port BASE+7 

Once the base address has been established by setting DIP switch 
7C, the addresses of all I/O functions on the WB I/O are 
determined (see I/O MAP on the following page). In order to gain 
access to a specific device function, however, the group number 
of that device function must first be output to I/O port BASE+7. 
The I/O group is selected by executing an output instruction to 
port BASE+7 with data bits and 1 set as follows: 



Table 3-2: Output to GROUP SELECT Port BASE+7 



Data Bit-1 Data Bit-0 Group Number 



1 1 
10 2 

1 1 3 



Use of the group select port is best described by example. Sup- 
pose you want the I/O space taken by the WB I/O to extend from 
48 hex to 4F hex and you want to access serial port and daisy- 
wheel printer port 0. First set the I/O base by turning 7C, 
paddles 3 and 6 ON and paddles 2, 4 and 5 OFF. With this base 
address selected, the GROUP SELECT port is at BASE+7, or port 4F 
hex. In order to read serial device number two, the user first 
outputs a 2 to the GROUP SELECT port. Further outputting or 
inputting to ports 48 hex through 4F hex controls the registers 
for the number two ACE serial device. To access the parallel 
daisy-wheel printer port, the user would then output a to the 
GROUP SELECT port. It is important to remember that the func- 
tions of ports at BASE to BASE+6 change from device to device 
depending upon the last value sent to the group select port. The 
following chart depicts the configuration of the GROUP SELECT 
port. 

Table 3-3: I/O Map-out BASE+7 

D 1 D Gp.# Device 

x0 x0 x0 xDAISY ports, 1990 clock, PIC, aux. par. port 

11 Serial port 1 (IC 6D, cable connector PI) 

10 2 Serial port 2 (IC 5D, cable connector P2) 

113 Serial port 3 (IC 4D, cable connector P3) 

The GROUP control register is I/O port BASE+7. To select an I/O 
group, output to port BASE + 7 with data bits and 1 set as 
indicated above. Once a group is selected, ports are assigned as 
follows: 



Table 3-4: GROUP Assignments 



I/O Address 



GROUP 



BASE 

BASE+1 

BASE+2 

BASE+3 

BASE+4 

BASE+5 

BASE+6 



Input 



DAISY IN (STATUS) 
Switch/ Parallel port flags 
R.T. Clock IN/RESET CLK. Int 
Parallel data IN 
8259 register 
8259 1 register 
not used 



Output 

DAISY OUT 
DAISY 1 OUT 
R.T. Clock OUT 
Par. data OUT 
8259 register 
8259 1 register 
Par. port cntrl. 



GROUPS 1, 2 & 3 - 8250 ACE Serial I/O Ports 



Input 

BASE Receive buffer 

BASE+1 Interrupt Enable 

BASE+2 Interrupt Identify 

BASE+3 Line Control register 

BASE+4 Modem Control register 

BASE+5 Line status register 

BASE+6 Modem status register 



Output 

Transmit buf fer/LSB baud 
Interrupt Enable/MSB baud 

not used 
Line Control register 
Modem Control register 

not used 

not used 



Note that an output to BASE+7 always assigns an I/O group but has 
no function within any given I/O group. 



4. THE INTERRUPT SYSTEM 

Microcomputer systems in general are required to communicate with 
peripheral devices such as printers, CRT terminals and various 
types of parallel devices. There are classically two ways of 
approaching the way a CPU may service these devices - polled and 
interrupt. 

In a polled mode, every device in the system is periodically 
querried about its service requirements. When a device requires 
servicing (for example, a person has just typed a character on a 
CRT terminal), the CPU stops polling all other devices until it 
has finished servicing the user's request. From a system view- 
point the CPU should handle these requests as quickly as 
possible. The total system throughput is a function of the 
number of devices on the system, the length of time to poll each 
device and service each device request. The operating system is 
never idle; it is always polling the devices searching for 
activity. 



There is a direct analogy here to hardware design: This type of 
operation is said to be synchronous, meaning the CPU may branch 
to a service request subroutine only after it has determined from 
the device, through polling, that it is necessary to do so. 
There are certain problems with this approach, though. These lie 
in the amount of time needed to service each request. Another 
disadvantage lies in the lack of priority-setting for the peri- 
pheral devices. In a polled system, each device has equal 
status, which is unfortunate because in a real environment some 
devices require faster, more frequent service response than 
others. Polling high priority devices more frequently is one 
solution, but this burdens the system I/O subroutines with com- 
plex algorithms. Another disadvantage is that the processor is 
always occupied with the polling process and not able to perform 
other tasks. 

An interrupt-driven system is much different in its 
implementation. Although requiring more hardware and more 
complex software, the system has none of the problems associated 
with a polled system. With correct hardware, the devices are all 
prioritized according to their service requirements and the CPU 
is free to handle other tasks until a device requires service. 
The I/O devices themselves in this system interrupt whatever the 
CPU is presently doing only when they require something from the 
host processor. This type of system is more analogous to an 
asynchronous hardware design - one where events can occur at 
random intervals not related to the CPU's operations. Its random- 
ness corresponds nicely with the relative randomness of device 
requirements tied into the system and allows maximum system 
response to these peripherals. 

4.1. The Programmable Interrupt Controller (PIC) 

This section describes the use of the PIC in the WB I/O, but 
before going any further, one assumption must be made: If using a 
Z80 CPU chip, an Enable Interrupt (EI) instruction must be 
executed and the Z80 set to Interrupt Mode (8080 mode). The 
PIC instructions and modes are described in further detail in the 
following pages. 

The additional hardware design requirements in an interrupt 
system have been kept to a minimum in this system by using an 
8259-A programmable interrupt controller integrated circuit chip. 
By using this chip in conjunction with standard integrated 
circuits a powerful interrupt driven system has been implemented. 
This section describes the software requirements necessary to 
utilize the PIC to its fullest. 

The PIC can directly monitor the requirements of eight separate 
devices and prioritize them according to system requirements. 
The system has three serial channels (the hardware uses three 
Universal Asynchronous Receive Transmit integrated circuits 
called UARTs) which are normally connected to CRT terminals or 
a serial printer. These three devices are tied directly to the 



PIC to provide a signal when they require servicing. The WB I/O 
also has a DAISY port which can generate a signal for the printer 
whenever it requires servicing. Besides the UARTs and the DAISY 
port, the on-board real-time clock may be programmed to generate 
interrupts at precise, software-selected intervals. Multi-user 
systems in general require a real-time clock to insure proper 
allocation of the CPU's time among various tasks. 

So far we have described five of eight possible events the PIC 
may monitor. Besides these, the system provides the user with 
the option to monitor three of the S-100 vectored interrupt 
lines. These lines are jumper options on the WB I/O which allow 
the the on-board PIC to monitor and prioritize interrupts gener- 
ated by boards plugged into the S-100 bus such as disk control- 
lers or Multl/O boards. 

4.2. PIC Interrupt Vectors 

To signal the host CPU that one of the monitored devices requests 
service, the PIC must issue a signal called PINT (processor 
interrupt, line-73 of the S-100 bus) to the host CPU. The host 
CPU completes its current instruction and issues a signal called 
SINTA (interrupt acknowledged, line-96 of the S-100 bus) 
indicating it has recognized the requested interrupt and is 
willing to receive its next instruction from the interrupting 
device, in this case, the PIC. 

At this point, a device may generate any instruction it wishes 
and the host CPU will execute it. Two logical instructions might 
be asked of the CPU in such a case - a Restart or a Call. These 
are logical choices because both of them predictably alter the 
current flow of instruction by changing the value of the Program 
Counter to a given address, then saves the location where the CPU 
is to return afterwards by pushing the current Program Counter 
onto the stack. The Restart instruction is limited to eight 
locations where the program may branch, making this instruction 
dependent on hardware and software environments and leaves us 
with the Call instruction. 

The PIC has been designed to generate a Call instruction upon 
receiving the SINTA response from the host CPU. The CPU then 
fetches a 16-bit address of the location of the interrupt vector. 
Hardware on the WB I/O counts the next two CPU fetches (the 
address vector) and enables the PIC to output this address to the 
data-in bus. When programmed, the PIC has eight vector addresses 
associated with it that correspond to the eight interrupt devices 
it monitors. The vector contains a jump instruction to the ad- 
dress of the routine responsible for handling it. 

The PIC generates interrupt vectors at either eight-byte or four- 
byte intervals in the 16-bit address space, limited by both the 
PIC and the CPU to a 64K address space. For compactness, most 
routines use the four-byte separation since a jump instruction is 
only three bytes long and few interrupt service routines fit in 



less than an eight byte address space. The eight-byte interval 
is provided for compatibility with the use of the 8080 and Z80 
restart instructions which are spaced eight bytes apart. The 
following is a map of the hardware devices associated with the 
PIC input line. 

Table 4-1 i Map of the Hardware Devices Associated With PIC Input Lines 

IRQ Line Device 

Highest S-100 vectored interrupt 

1 S-100 vectored interrupt 1 

2 S-100 vectored interrupt 2 

3 Serial Device #1 

4 Serial Device #2 

5 Serial Device #3 

6 DAISY print wheel ready 
Lowest 7 Real-time clock TP line 

4.3. PIC Modes 

The PIC, being a software programmable device, can be set up in 
many different modes allowing itself to be tailored to any 
operating environment. The Decision 1 environment takes 
advantage of some of these features and the user is free to 
explore others. This section explores some of the more common 
PIC modes. For a rigorous description of the different modes 
please refer to the Intel Data Sheet and Application Note. 

4.3.1. Triggered Modes 

The PIC may be programmed to monitor the eight devices in 
either edge-triggered or level-triggered mode. In the edge- 
triggered mode, the PIC generates an interrupt when it senses 
a change on one of its eight input lines (IRQ0 - IRQ7). This 
is suitable for events that do not latch their interrupt 
requests to the PIC. However, this does cause a problem when 
the UARTs generate one edge only for one or more interrupts. 
The result is a possible loss of some interrupt requests. 
For this reason, all Morrow Designs software use only the 
level-triggered mode. 

4.3.2. Master/Slave Mode 

The PIC may be programmed to be either a single system PIC or 
part of a larger interrupt system involving up to four PlCs. 
This would be the case in a system where more I/O is required 
and one or more Morrow Designs I/O controller boards has been 
installed. In a multiple configuration, one PIC is designated 
as the Master and is the only .device which may control the 
PINT line on the S-100 bus. All other PICs drive the 
selected S-100 vectored interrupt lines monitored by the 
Master PIC. However, cascading of multiple PICs is not 
supported in the WB I/O hardware implementation. 
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4.3.3. Buffered Mode 

The buffered mode option for the PIC is not implemented on 
the WB I/O board. 

4.3.4. End of Interrupt (EOI) Mode 

An in-service bit (IS) on the PIC indicates a pending 
interrupt. This may be reset manually by the interrupt 
service routine of the CPU, or automatically after the third 
byte of the Call instruction has been sent by the PIC. An 
automatic End of Interrupt (AEOI) instruction is programmable 
at the time of initialization only, so once set, the PIC must 
be re-initialized to change this mode. In AEOI mode, the 
full nesting capabilities of the PIC are lost. For this 
reason, and for maximum system flexibility, all Morrow 
Designs software has been written with the AEOI feature 
disabled. 

4.3.5. Polled Mode 

The PIC may be configured to resemble a polled I/O system by 
setting the Poll bit to a logic *1'. In this mode, the PIC 
does not generate an interrupt with a change in state on any 
of its IRQ0 - IRQ7 lines. The CPU issues a Poll command to 
the PIC, the PIC then gates a byte onto the data-in lines to 
the CPU indicating the highest priority interrupt pending. 
The lower three bits of the byte are used to indicate which 
device requires service. The highest bit, if set, indicates 
a device is requesting service. 

4.3.6. Nested Mode 

The nested mode of the PIC allows service requests from I/O 
devices to be prioritized. When a device is in need of 
service, the PIC issues an interrupt to the host CPU only if 
there are no higher priority devices requesting service via 
the PIC. If a lower priority device requires service, it 
must wait until all higher priority devices are serviced and 
the interrupt-handling subroutine has issued an EOI command 
to that PIC. If a device of higher priority requires 
service, the lower priority device's service subroutine is 
interrupted until the higher priority device has been ser- 
viced. Although this requires intricate software routines to 
keep track of the signals, this mode allows maximum system 
response to devices which require immediate service. All 
Morrow Designs software take advantage of the PIC nesting. 



4.3.7. Rotating Priority - Mode A 

In the nested mode, devices are prioritized and the device 
with highest priority obtains service. The priorities are 
assigned according to which input line (IRQ0 - IRQ7) a device 
is connected. This scheme works well for devices not 
inherently equal. In some instances all eight devices 
connected to the PIC have the same priority. The PIC may be 
programmed to rotate the priority through all devices. In 
this mode, each device gets rotated to the lowest priority 
after it has been serviced; all other devices are raised one 
level in the priority ladder. At present, Morrow designs 
software does not implement the rotating priority option. 

4.3.8. Rotating Priority - Mode B 

This mode is very similar to Mode A, the difference being 
rotation in Mode B can be controlled with software as opposed 
to a fixed rotation controlled by hardware internal to the 
PIC, as in Mode A. The software is only allowed, however, to 
set that device with the lowest priority. All other devices 
are ordered by priority via the PIC. The next lowest priority 
device is then shifted into the highest priority spot. For 
instance, if IRQ2 was set as the lowest priority, the PIC 
automatically sets IRQ3 as the highest. 

4.4. PIC Status Registers 

The PIC status registers may be read to determine the current 
state of the PIC. These registers place IRQ0 - IRQ7 status on 
data-in bits, 0-7 respectively. IRQ0 is assumed to be the 
highest priority and IRQ7 the lowest. 

4.4.1. Interrupt Mask Register (IMR) 

The PIC has the capability of masking any one of eight 
interrupt inputs - i.e. not allowing that particular device 
to generate an interrupt. The mask register contains eight 
bits, any of which, when high, shut off the appropriate IRQ 
input to the PIC. If all the bits are set high, no 
interrupts are generated. If all are set low, all devices 
are recognized in their normal prioritized sequence. This 
allows the software complete control over each individual 
device's service requests. The register can be written and 
read by the system software. 

4.4.2. In-Service Register (ISR) 

The in-service register allows the software to query the PIC 
for those devices currently being serviced. Each of the 
eight lines are associated with eight bits. A high level 
indicates that device being serviced. Bits in this register 
are reset by the software issuing an EOI (either specific or 
non-specific) at the end of the associated interrupt service 
routine. 
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4.4.3. Interrupt Request Register (IRR) 

This eight-bit register is read to determine which of the 
eight devices is requesting service. The highest pending 
priority is reset whenever an interrupt from the PIC has 
been acknowledged by the CPU. (This register is not affected 
by the IMR - a device may request an interrupt and be masked 
out. ) 



5. PROGRAMMING THE PIC 

The PIC is a programmable device and must be initialized for 
correct operation. 

NOTE: If the PIC is not initialized, it is still possible for it 
to generate spurious interrupt requests to the host CPU. 
Programs such as DDT - the Dynamic Debugging Tool by Digital 
Research - only aggravate this problem by issuing Enable Inter- 
rupt instructions whenever the 'GO' command is invoked. This 
caution should be followed in systems where interrupts are not 
implemented as well. 

The PIC is accessed through system ports BASE+4 and BASE+5. 
Since context plays an important role in determining what each of 
these ports control, remember this rule: outputting to BASE+4 
sets PIC address bit-A0 to a '0' or low logic level; outputting 
to BASE+5 sets PIC address line A0 to a ' 1' or high logic level. 
There are two types of registers internal to the PIC. Registers 
referred to as ICW are initialization registers and are typically 
accessed only when the PIC has been first powered up. Registers 
referred to as OCW are operation control registers and are read 
from and written to during regular PIC operation (subsequent to 
initialization) . 

5.1. Initialization Registers 

The PIC is ready to accept commands for initialization on power- 
up. There are a minimum of two registers in the PIC which must 
be initialized for the PIC to begin servicing interrupt requests. 
Depending on the mode the user operates in, as many as four 
registers must be initialized prior to operation. These 
registers are detailed below. 

5.1.1. Initialization Control Word 1 (ICWl) 

The first word written to initialize the PIC is ICWl. It is 
specified by outputting to port BASE+4 a value with data bit- 
4 set logic high. This informs the PIC that the 
initialization sequence is beginning. In addition to bit-4 
being set, the other bits are assigned the following 
function: 
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Table 5-1: ICW1 Bit Assignments 

Bit Function 

7 Part of the high byte of the beginning address of 
the interrupt vectors; bit-A7 of the call address. 

6 Part of the low byte of the beginning address of 
the interrupt vectors; bit-A6 of the call address. 

5 Part of the low byte of the beginning address of 
the interrupt vectors; bit-A5 of the call address. 

4 Set high to begin initialization sequence. 

3 LTIM - set to 1 for level-triggered mode (normally 
high for all Morrow Designs software) . 

2 ADI - Call address interval. Low for call address 
at eight-byte intervals, high for four-byte inter- 
vals (normally high for all Morrow Designs sof- 
tware ) . 

1 SNGL - Single or multiple PICs in the system to be 
used in cascade mode. Since WB I/O does not 
support cascading, this bit set to a 1 . 

ICW4 - This bit set high allows access to the 
Initialization Control Word 4 for selection of 
operation modes. If this bit is set low, the PIC 
initialized as master, non-buffered mode, no AEOI 
and in the normal nested mode (normally low for all 
Morrow Designs software; set this bit low when 
initializing) . 



5.1.2. Initialization Control Word 2 (ICW2) 

Initialization Control Word 2 is available at BASE+5 after 
ICW1 has been selected and initialized. The ICW2 register 
contains the high byte of the call address vector starting 
address. The bits are configured as follows: 
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Table 5-2: ICW2 Bit Assignment 

Bit Function 

7 Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-A15 of the 
call address . 

6 Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-A14 of the 
call address. 

5 Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-A13 of the 
call address . 

4 Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-A12 of the 
call address. 

3 Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-All of the 
call address. 

2 Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-A10 bit of 
the call address . 

1 Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-A9 of the 
call address. 

Part of the high byte of the beginning address of 
the interrupt vectors. This is bit-A8 of the 
call address. 
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5.1.3. Initialization Control Word 3 (ICW3) 

Morrow Designs implementation does not require the initiali- 
zation of ICW3. If the cascade feature is absolutely re- 
quired within a system configuration, a Morrow Designs Mult 
I/O board should be installed to become the master PIC for 
the system. The user is free to explore this option and is 
referred to the Mult I/O manual for details on both that 
board and on cascading PICs. 

5.1.4. Initialization Control Word 4 (ICW4) 

This register is available at BASE+5 if the ICW4 access bit 
of register ICW1 (bit-0) was not set when beginning the PIC 
initialization routine. Normally, this register need not be 
accessed as all bits are automatically cleared to the mode 
that Morrow Design's software uses. If the user wishes to 
change to AEOI, buffered, slave or fully nested mode, he is 
free to program this register appropriately. 

5.2. Operation Control Registers 

One the PIC is initialized, it is ready to function as the system 
interrupt controller. Further changes in the PIC operating 
parameters are accomplished by programming a set of registers 
referred to as the Operation Control Registers. 

5.2.1. Operation Control Word 1 (0CW1) 

This register contains a software mask that allows the 
operating system to mask out any of the eight interrupt 
inputs and is available any time after initialization 
sequence through port BASE+5. Setting any of the bits high 
forces the PIC to ignore the interrupt request line 
associated with that bit. The bits are arranged with data 
bit-7 corresponding to IRQ7 and data bit-0 corresponding with 
IRQ0. As indicated, a bit set high masks the interrupt 
request; a bit set low unmasks it. The PIC clears this 
register to (all enabled) on power up. 
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5.2.2. Operation Control Word 2 (OCW2) 

Operation Control Word 2 (0CW2) is selected by outputting to 
BASE+4 with bits 3 and 4 reset (logic 0) any time after the 
initialization sequence. On power up, these bits are all 
reset (logic 0). This registers allows control over the 
following functions: 

Table 5-3: OCW2 Bit Assignments 

Bit Function 

4 Must be low to access 0CW2. 

3 Must be low to access 0CW2 . 

2 L2 - Specific end of interrupt bit-2 (MSB) 

1 LI - Specific end of interrupt bit-1 

L0 - Specific end of interrupt bit-0 (LSB) 

Bits 5, 6 and 7 are multiplexed and have the following 
functions: 

Function Bit-5 Bit-6 Bit-7 

Clears rotate 
priority - 



Mode A flip-flop 











End of Interrupt 


1 








Specific Interrupt 


1 


1 





Sets rotate 

priority - 

Mode A flip-flop 








1 



EOI causes 

rotate - 

priority Mode A 1 

Sets rotate 

priority Mode B 1 

EOI causes rotate 

priority Mode B 1 1 



15 



5.2.3. Operation Control Word 3 (OCW3) 

Operation Control Word 3 (0CW3) is selected by outputting to 
BASE+4 with data bit-^3 set and bit-4 reset (logic 0) any 
time after the initialization sequence. On power up, these 
bits are all reset (logic 0). Morrow Designs software does 
not use this register and leaves all bits reset. This regis- 
ter allows control over the following functions: 

Table 5-4: OCW3 Bit Assignments 

Bit Function 

7 Not used 

6 ESMM - Enable Special Mask Mode when high. 

5 SMM - Special Mask Mode when high. 

4 Must be to access 0CW3 

3 Must be 1 to access 0CW3 

2 Enter poll mode when high, interrupt mode when 

low. A high on this line allows the next read 
BASE+5 to read the BCD code of the highest 
interrupt request pending (in non-interrupt 
environments) . 

1 SRIS - allows access to the Interrupt 

Request register (IRR) and the In-service 
register (ISR). 

RIS - when low, allows access to the 

IRR by reading port BASE+5. When high, al- 
lows access to the ISR by reading port BASE+5. 

5.3. Interrupt Status Registers 

During normal PIC operation it may be desirable to examine the 
status and operating parameters of the device. There are three 
readable registers on the PIC which contain status information. 
They are accessed by inputting from the appropriate port and are 
defined as follows: 
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5.3.1. Interrupt Mask Register ( IMR) 

The interrupt mask register may be read at any time by 
inputting from WB I/O port BASE+5. This eight-bit port 
contains a map of the IRQ lines which have been previously 
masked by outputting to BASE+5, the 0CW1. If no IRQ lines 
are masked, all bits are low (logic 0) which is the normal 
condition on power-up. Any IRQ line that is masked has its 
appropriate bit set. IRQ7 is data bit-7 and IRQ0 is data 
bit-0. 

NOTE: The following two status registers are 
selected by setting the appropriate bits with 0CW3. 
The registers is then available through BASE+4. The 
state of 0CW3 bits and 1, (SRIS and RIS) once set, 
will allow continuous access to the selected register 
until the bits are changed (bits are internally 
latched by the PIC). 

5.3.2. Interrupt Request Register (IRR) 

The IRR is an eight-bit register which, when read by input- 
ting from WB I/O BASE+4, tells which of the IRQ lines are 
currently asserted at a high logic level and are awaiting 
acknowledgement. By reading this register, it is possible to 
determine which interrupt requests have been recognized and 
which have yet to be acknowledged. Bit-7 maps to IRQ7 and 
bit-0 maps to IRQ0. After initialization, this register may 
be read from BASE+5 as long as 0CW3 is not changed (i.e. 0CW3 
bits ERIS = 1 and RIS = 0). The register is updated each 
time an interrupt request is acknowledged by the CPU. 

5.3.3. In-service Register (ISR) 

The in-service register (ISR) is an eight-bit register 
containing information on which priority levels are currently 
being serviced. By reading this register (inputting BASE+4 
with the 0CW3 bits ERIS = 1 and RIS = 1), the user determines 
the number of the IRQ lines being serviced. IRQ7 maps to 
data bit-7 and IRQ0 maps to data bit-0. A logic high level 
on any bit indicates that the associated IRQ line is in 
service. The register is updated each time an EOI is issued. 
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Table 5-5: Typical Initialization Sequence 
************************************************************** 

This routine will initialize the PIC as a single, 
master PIC, non-buffered mode, level-triggered, no 
automatic End of Interrupt (AEOI disabled), regular 
nested mode with the call vectors at 4 byte inter- 
vals. Although ICW4 and 0CW1 are cleared to zero on 
power-up, the routine initializes them for complete- 
ness. 

**************************************************************** 



base 


equ 


048h 






grpsel 


equ 


base 


+ 


7 


group0 


equ 









init 


equ 


010h 






icwl 


equ 


base 


+ 


4 


icw2 


equ 


base 


+ 


5 


icw3 


equ 


base 


+ 


5 


icw4 


equ 


base 


+ 


5 


ltim 


equ 


08 






adi 


equ 


04 






sngl 


equ 


02 






IC4 


equ 


01 






lovect 


equ 


0E0h 






hivect 


equ 


0ffh 






normal 


equ 










ocwl 



equ 



base + 5 



;base port address 
; group select port 

bit high to initialize the PIC 

initialization control word 1 

initialization control word 2 

initialization control word 3 

initialization control word 4 

Level-triggered mode 

Call address interval = 4 bytes 

one PIC in the system 

ICW4 access bit 

low byte of interrupt vector address 

high byte of interrupt vector address 

master/reg. nest/non-buffered/no 

AEOI/8085 

-normal mode for Morrow software 
operation control word 1 - MASK 



begin: 



mvi 


a,group0 


out 


grpsel 


mvi 


a, lovect 


out 


icwl 


mvi 


a, hivect 


out 


icw2 


mvi 


a, normal 


out 


icw4 


out 


ocwl 


ret 





+ init + ltim + adi + sngl + IC4 



; vectors begin at address FFE0h 



This code initializes the PIC to generate the call instructions 
to addresses at four byte intervals beginning at FFE0h. Jump 
vectors to the interrupt service routines must be placed in these 
locations by the system software. The interrupt service vectors 
are as follows: 
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Table 5-6: Interrupt Service Vectors 

Call Vector (hex address) 



IRQ Line 


Device 




Call Vei 





S-100 V0 




FFE0 


1 


S-100 VI 




FFE4 


2 


S-100 V2 




FFE8 


3 


Serial Device 


1 


FFEC 


4 


Serial Device 


2 


FFF0 


5 


Serial Device 


3 


FFF4 


6 


Daisy PWR line 


FFF8 


7 


RT Clock TP line 


FFFC 



5.4. System Software Requirements 

A typical system interrupt service routine (ISR) to service the 
PIC on the WBI/O must perform the following functions: 

1. Enable interrupt instructions to the CPU. 

2. When the interrupt occurs, the ISR saves the registers to 
be restored when the interrupt routine returns to the 
routine it interrupted . 

3. Service the device which generated the interrupt. 

4. Send an Enable Interrupt (EI) instruction to the CPU. This 
is necessary because interrupts are automatically disabled 
by the CPU whenever an interrupt has been received . 
Failure to do so prevents further interrupts to be acknow- 
ledged by the CPU. Once enabled, higher priority inter- 
rupts than the one being serviced are honored by CPU. 

5. Send and EOI (end of interrupt) to the PIC. This would mean 
sending a 20h to WB I/O port BASE+4 of GROUP 0. This 
allows the current ISR to be interrupted by a device of same 
or lower priority. 

6. Restore all the registers of the interrupted routine and 
return to that routine. Since the ISR was invoked 
through use of a Call instruction, a Return in- 
struction must be executed to restore the Stack Pointer 
to its original position. 
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6. ACE SERIAL PORTS 

The WB I/O has three 8250 programmable Asynchronous 
Communications Elements (ACE's) which can be connected to RS-232 
devices via three 25-pin D-type connectors. Each ACE has an I/O 
group dedicated to it - GROUPS 1, 2 and 3. The ACE's are pro- 
grammable and must be initialized before they can be used. Ini- 
tialization includes setting the baud rate, word length, parity, 
number of stop bits, and interrupt conditions. Each ACE can be 
programmed to generate an interrupt in response to up to ten 
conditions (e.g., data available, transmitter buffer empty, 
etc.). The interrupt is sent directly to the WB I/O PIC which 
can in turn pass it on to the host CPU. The interrupt handling 
routine then interrogates the interrupt status register of the 
ACE responsible for generating the interrupt, and is thus able 
to determine the precise cause of the interrupt. 

The following chart describes the ACE devices on the WB I/O, 
including the location of the 8250 on the circuit board, the 
location of the 26-pin ribbon cable connector associated with 
each ACE, the I/O GROUP controlling each ACE, and the interrupt 
level assigned to each device by the 8259-A PIC. 

Table 6-1: ACE I/O GROUP Description 









I/O 


25-pin 


Board 


Interrupt 








GROUP # 


Connector 


Location 


Level 


ACE 


# 


1 


1 


PI 


6D 


3 


ACE 


# 


2 


2 


P2 


5D 


4 


ACE 


# 


3 


3 


P3 


4D 


5 



PI is the right-most connector with the board-oriented connectors 
facing you. P2 is the connector immediately left of PI and P3 is 
to the left of P2. 

The pins on the DB25-S type connectors P1-P3 are configured as 
follows (as viewed from the rear of the computer): 

13 12 11 10 9 8 7 6 5 4 3 2 1 

25 24 23 22 21 20 19 18 17 16 15 14 

The pins have been arranged to conform as closely as possible to 
the IEEE RS-232 communications equipment standards for data 
terminal equipment. The following is a pinout guide for the DB- 
25 connector. 
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Output 


3 


From 


4 


WB I/O 


2l 


Input 


2 


To 


5 


WB I/O 


6 




8 




1 




7 



Table 6-2: ACE Serial Connectors 
Connector Pin Definition ACE Mnemonic 

Transmit data SOUT 
Request to Send RTS 



Data Terminal 
Ready 

Receive data 



DTR 



SIN 



Received Signal 




Detect 


RCSD 


Data Set Ready 


DSR 


Clear to Send 


CTS 


(chassis ground) 




(signal ground) 





7. PROGRAMMING THE 8250 

Any 8250 device on the WB I/O can be accessed if its I/O group is 
currently selected. Once a 1, 2 or 3 has been output to GROUP 
SELECT port BASE+7, ACE device number 1, 2 or 3 can be accessed. 
Each ACE contains internal 8-bit registers which occupy the first 
seven I/O ports of the WB I/O space, or ports BASE to BASE+6. 
The ACE registers accessed after the correct group has been 
selected are dependent on the status of the Most Significant Bit 
(MSB) of the line control register (BASE+3). If this bit is 
high, BASE and BASE+1 access the divisor latch low byte and high 
byte, respectively. Since the ACE has programmed baud rates, 
these registers must be programmed for the desired baud rate 
(refer to the data sheet on the 8250 for the common divisor latch 
values). If the MSB of the line control register is low, the 
register at BASE becomes the RECEIVE buffer or TRANSMIT buffer, 
depending on whether it is a read or write operation. The 
register at BASE+1 becomes the Interrupt Enable register. The 
following is a summary of the 8250 registers: 
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Table 7-1 i Registers for the 8250 



I/O Port 


Operation 


of D 


BASE 


Write 





BASE 


Read 





BASE 


Write 


1 


BASE+1 


Read/Write 





BASE+1 


Write 


1 


BASE+2 


Read 


X 


BASE+3 


Read/Write 


X 


BASE+4 


Read/Write 


X 


BASE+5 


Read/Write 


X 


BASE+6 


Read/Write 


X 



Condition 
of DLAB Register 



Transmitter buffer 
Receiver buffer 
Divisor latch - low byte 
Interrupt Enable register 
Divisor latch - high byte 
Interrupt ID register 
Line Control register 
Modem Control register 
Line Status register 
Modem Status register 



7.1. Baud Rate 



X= Not important 



The 8250s on the WB I/O have been hard wired so the baud rate for 
data coming in is the same as for data going out. The crystal 
used to provide the reference frequency for the three ACE devices 
on the WB I/O is 1.8432 Mhz. The data sheets give a broad sample 
of the divisors which must go into the divisor latch in order to 
generate the most common baud rates, and generally any baud rate 
may be generated from DC to 56,000 baud (a zero in the divisor 
latch inhibits all data transmission) . The formula for determin- 
ing the divisor constant to produce a given baud rate is: 

DIVISOR = 1.8432 M/ (BAUD RATE X 16) 

Although in most applications the user will simply look up the 
baud rate divisor in the data sheet table, there are instances 
when odd ball baud rates may be useful. For example, an ACE is 
being used to generate interrupts at timed intervals based on the 
Transmitter Holding Register Empty Interrupt (see Serial Device 
Interrupts) . 
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The following is a list of the divisor latch constants for the 
standard baud rates (values are in decimal): 

Table 7-2: Divisor Latch Constants for Standard Baud Rates 



ntents 


Baud rate 


2304 


50 


1536 


75 


1047 


110 


857 


134.5 


768 


150 


384 


300 


192 


600 


96 


1200 


64 


1800 


58 


2000 


48 


2400 


32 


3600 


24 


4800 


16 


7200 


12 


9600 


6 


19200 


3 


38400 


2 


56000 



7.2. Initialization 

Though the reset pin (MR) of each 8250 is asserted during power 
ON or RESET, no assumptions should be made about the contents of 
any 8250 register unless that register has been initialized. 
Keep in mind that an on-board ACE cannot be accessed, much less 
initialized, unless its I/O group is selected. Furthermore, the 
Line Control, Modem Control, Interrupt Enable and Divisor Regis- 
ters are normally initialized before any data can be transferred 
to or from an 8250. 

The following three software routines are brief samples of how a 
WB I/O ACE device could be driven in a CP/M* type environment. 
All these routines adhere to CP/M* I/O protocol. The INIT 
routine sets up ACE # 1 to run at 9600 baud with an eight bit 
word, no parity and two stop bits. The Interrupt Enable Register 
is set to generate no interrupts, and the Modem Control Register 
is ignored. This initialization would be appropriate for most 
RS-232 CRT terminals in a non-interrupt driven environment. 
Assume that the WB I/O I/O has been set to begin at 48H. The 
cluster of assembler directives (equ's) at the beginning of 
these routines establish constants which hold for all three 
specimen routines. The comments included with these routines may 
be used as a general flow analysis of ACE programming. 

*CP/M is a trademark of the Digital Research Corporation. 
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Table 7-3: Sample I/O Routines 



groupl 


equ 


1 


base 


equ 


48h 


dll 


equ 


base 


dim 


equ 


base+1 


ier 


equ 


base+1 


lcr 


equ 


base+3 


Isr 


equ 


base+5 


rbr 


equ 


base 


thr 


equ 


base 


dlab 


equ 


80h 


thre 


equ 


20h 


dr 


equ 


1 


baudl 


equ 


12 


baudh 


equ 





wls0 


equ 


1 


wlsl 


equ 


2 


stb 


equ 


4 


imask 


equ 






code for first ACE (attached to Jl) 
base I/O address set by SW-7C 
ACE baud rate divisor (lsb) 
ACE baud rate divisor (msb) 
ACE interrupt enable register 
ACE line control register 
ACE line status register 
ACE receiver buffer register 
ACE transmitter holding register 
divisor latch access bit 
line status register THRE bit 
line status register DR bit 
divisor latch low byte — 9600 baud 
divisor latch high byte — 9600 baud 
word length select bit — 8 bit word 
word length select bit 1 — 8 bit word 
stop bit count — 2 stop bits 
interrupt mask — disable all 



;The following routine initializes the ACE as described above 

init: mvi a, groupl ;set up desired I/O group 

out grpctl ; select first serial device 

;next set up format and set dlab 

mvi a,dlab+wls0+wlsl+stb 

out lcr ;base reg is now lsb baud rate reg 

mvi a,baudl ;low byte of baud rate constant 

out dll ;into low baud rate register 

mvi a, baudh ;high byte of baud rate constant 

out dim ;into high baud rate register 

;set up format and clear dlab 

mvi a,wl0+wll+stb 

out lcr ;into line control register 

xra a ; zero register a 

out lsr ; clear data available flag in line status 

mvi a, imask ; interrupt mask set up 

out ier ; base+1 now interrupt mask- not baud 
ret rend of initialization routine 
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Table 7-3 Cont. 



The following routine will return in the accumulator any new 
character typed to ACE #1 

conin: mvi a,groupl 

out grpctl ;put a 1 into WB I/O group select port 

;make sure dlab is cleared 
a,wls0+wlsl+stb 

lcr ;make base port the ACE data register 
lsr ;get line status register 
dr ;any new data from terminal? 
coninl ;if no then keep waiting 
rbr ;get data 
7fh ; strip off bit 7 of input character 

; return with data in accumulator 



mvi 
out 
coninl: in 
ani 

jz 
in 
ani 
ret 



The following routine will output the character in Register C 
to ACE # 1 



conout: 



mvi 
out 



mvi 
out 
conoutl : in 
ani 

jz 
mov 
out 
ret 



a,groupl 

grpctl ;put a 1 into WB I/O GROUP SELECT port 

;make sure dlab is low 
a,wls0+wlsl+stb 

lcr ;make base port the ACE data register 
lsr ;get line status 
thre ;is ACE ready to transmit? 
conoutl ;if not then keep waiting 
a,c ; transfer data from reg c to reg a 
thr ; output character typed from terminal 

; return to calling program 



The following routine will return an FF in the Register A if ACE 
device # 1 has received a new character (i.e., DR is set in the 
ACE line status register). Otherwise, return a 0. 



status : 



mvi 

out 

in 

ani 

rz 

mvi 

ret 



a,groupl 

grpctl ;put a 1 into WB I/O GROUP SELECT port 

lsr ;get line status 

dr ; check DR bit 

; return if reg a is zero — no character 
a,0ffh ;ff into reg a since character is ready 
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In the above examples, it should be noted that the GROUP SELECT 
port is re-initialized at the beginning of every routine. This 
is done to insure against inadvertently sending serial I/O 
instructions to the clock, parallel ports or interrupt controller 
of the WB I/O. Further note that before accessing the ACE data 
register, the format word is sent again to the Line Control 
Register. This is done so that port BASE of GROUP 1 will be 
interpreted as a data port rather than as a divisor port. This 
guards against a situation such as losing access to the console 
device due to a careless reading of the divisor latch (from a 
monitor or front panel, for example) without subsequently clear- 
ing DLAB. 

7.3. Serial Device Interrupts 

The three 8250 ACE devices on the WB I/O each have a dedicated 
interrupt request line on the 8259 PIC. The chart below de- 
scribes the PIC interrupt level assigned to each ACE: 

Table 7-4: ACE Interrupt Assignments - 8259 PIC 

PIC Interrupt 
Serial Device Request Line 

ACE #1 IR3 

ACE #2 IR4 

ACE # 3 IR5 

7.4. ACE Interrupt Programming 

As explained in the data sheet on the 8250, each ACE device can 
be programmed to generate an interrupt on any of four general 
conditions. These conditions are, in order of descending 
priority: Receiver Line Status, Received Data Available, 
Transmitter Holding Register Empty, and Modem Status. The 
Received Data Available and the Transmitter Holding Register 
Empty interrupts can be identified directly from the Interrupt ID 
Register of the source ACE. 

The remaining two interrupts must use the Interrupt ID Register 
to point to either the Receiver Line Status Register or the Modem 
Status Register. These two registers each have four interrupt 
flags which can be read to identify the source of an ACE-gener- 
ated interrupt. (The third interrupt of the Modem Status 
Register - The Trailing Edge of Ring Indicator, or TERI - is not 
usefully supported by the WB I/O, since the Ring Indicator line 
of each ACE is tied to +5V. ) Because the 8250 prioritizes its 
interrupts, the Interrupt ID Register will 'freeze' the highest 
priority interrupt pending by ignoring all further interrupts 
until the previous interrupt has been serviced. See the data 
sheets for further information on the 8250. 
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When using the 8250' s ACE devices on the WB I/O to generate 
interrupts, it is advisable to set the 8259-A PIC to operate in 
level-mode, rather than edge-mode. In edge-mode, it is possible 
under certain circumstances for an ACE-generated interrupt to be 
'lost'- that is, to go unrecognized. The 8250 generates one edge 
for an interrupt and all interrupts which occur during the time 
when the first interrupt is active will not generate additional 
edges. In this situation, the interrupt line of the 8250 remains 
low until all interrupts have been acknowledged, but the 8259 PIC 
in edge-triggered mode has seen no additional edges to indicate 
the presence of further interrupts. 

8. THE PARALLEL DAISY-WHEEL PRINTER PORT 

The WB I/O contains parallel I/O ports configured to accommodate 
a standard Diablo-type daisy-wheel R/0 printer. These ports are 
brought out to the 50-pin ribbon cable connector at P5 (board 
location 8E - HE) for easy attachment. The pin assignments of 
P5 correspond exactly to those of an internal Diablo 50 conductor 
flat cable connector, so simply tying the Diablo to the WB I/O 
via a ribbon cable with female sockets at either end is the only 
hardware requirement for interfacing the two devices. 

The daisy-wheel interface standard requires 12 bits of data 
information and four strobe lines which determine the meaning of 
the data lines. These four strobes are: 

Table 8-1: Printer Strobe Lines 



RESTORE 



Send the print head to the 'home' position 
(position assumed when the printer is powered 
up) . 



PRINT WHEEL 
STROBE 



Indicates 12 bits of data on data lines con- 
tain characters to be printed and the strike 
intensity of the hammer. 



CARRIAGE 
STROBE 



Indicates that data lines contain the 
appropriate number of steps and direction the 
print head is to be moved. 



PAPER FEED - 



Indicates that data lines contain valid number 
representing amount of paper to advance or 
retract. 



RIBBON 



Lifts the ribbon cartridge in preparation to 
print a character. 



SELECT 



Low to select the printer. 
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The last two lines are additional daisy-wheel printer control 
lines. They are accessed through GROUP BASE+2 output port. 
Bit-6 generates the ribbon lift signal and bit-7 is an inverted 
version of the select signal. All software must account for this 
inversion for correct selection. (For more information on printer 
standards for Diablo-type systems, see referenced manual.) 

Two latched output ports (plus an extra latched output bit) and 
one transparent input port are used to communicate with the 
daisy-wheel printer. These ports can be used with almost any 
parallel device (e.g., a Centronics-style printer or a keyboard) 
provided that the I/O lines are properly routed from the WB I/O 
connector at P5 to the target device. This additional cabling 
burden is standard in parallel I/O interfacing, and so should not 
be considered as a major disadvantage by those using the DAISY 
port with a non-Diablo parallel device. 

The WB I/O daisy-wheel printer port occupies I/O ports BASE and 
BASE+1 plus a part of BASE+2 - all within I/O GROUP 0. A single 
input line (BASE+1 bit-5, or the Print Wheel Ready line when 
interfacing with a daisy-wheel printer) is, after going to the 
DAISY port, inverted, then brought to IRQ 6 of the 8259-A 
interrupt controller to generate an interrupt whenever it goes 
to a low logic state. The eight input lines brought to daisy- 
wheel printer port BASE are also pulled up to +5V through 180 
Ohms (nominal), and may be used with open-collector devices. 



These eight input lines are inverted by an input buffer; 
unconnected, appear to software as a high. 



if left 



The signal returning from the daisy-wheel printer indicates 
whether it can accept a new command from the WB I/O. The lines 
are defined as: 

Table 8-2: Printer Line Commands 



PRINTER READY - 



Power is ON and printer is ready to 
accept commands. 



CHECK 



Fault condition indicating either a 
software error (e.g. sending the print 
head too far in one direction) or 
hardware failure in the printer. 



P.W. READY 



Print wheel can accept a new character 
address . 
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Table 8-2 Cont. 



CARRIAGE READY - Carriage is ready to be repositioned. 



P.F. READY - Platen motor ready to advance or 

retract the paper. 



COVER OPEN - Case cover was removed. 



OUT OF PAPER - Printer has run out of paper. 



RIBBON OUT - A print ribbon cartridge has not 

been inserted or has run out. 

Connector P5, line 48, enables all daisy-wheel printer port 
output drivers. If this line is not tied to nominal +5 volts (if 
it is grounded or allowed to float) the DAISY port output lines 
controlled by I/O ports BASE, BASE+1 and BASE+2 , remain at a high 
impedance state regardless of any software commands. (Note that 
some printers such as C. Itoh do not supply this level and are 
non-standard Diablo interfaces.) In the event you have chosen 
such a printer and are not able to jumper pin-48 of the daisy- 
wheel printer connector to +5 volts, you may lift 4 of chip 10C 
and tie it to pin 7 of 10C using a short piece of 30 gauge 
insulated wire. 

WARNING: In no way does Morrow Designs support this 
modification or take responsibility for products 
which have been modified. This solution is provided 
here in the unlikely event you have purchased a non- 
standard daisy-wheel printer and have no way in which 
to modify the printer itself. It should be 
considered a temporary solution. 

The parallel ports have no special facility for generating a 
strobe on output or latching a strobe on input. All data lines 
operate as levels, so strobes must be generated in software. 

The following page depicts the parallel lines available on the WB 
I/O, including the I/O port and bit number controlling each line 
and the function assigned to each line on a standard parallel 
Diablo-type interface. Remember, these functions have no 
inherent meaning to the WB I/O; it only sees so many latches. Do 
not preclude interfacing the WB I/O with parallel devices other 
than daisy-wheel printers. 
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Table 8-3: Daisy-Wheel Printer Signals and I/O Map 

I/O Group 



I/O Data WB I/O and 
Port Bit Diablo Pin 



Diablo Function 



# 



Input BASE* 



Output BASE 



Output BASE+1 



Output BASE+2 




1 
2 
3 
4 
5 
6 
7 


1 
2 
3 
4 
5 
6 
7 


1 
2 
3 

4 
5 
6 
7 

6 
7 



4 

3 

5 
34 
26 

27 ** 
12 
28 

46 

1 

9 
10 
15 
17 
21 
13 

37 
36 
39 
33 
40 
42 
43 
45 

23 
24 



End of Ribbon (-) 
Paper Out (-) 
Cover Open (-) 
Paper Feed Ready (-) 
Carriage Ready (-) 
Print Wheel Ready (-) 
Check (-) 
Printer Ready (-) 

Data Bit 9 (256) (-) 
Data Bit 10 (512) (-) 
Data Bit 11 (1024) (-) 
Data Bit 12 (2048) (-) 
Paper Feed Strobe (-) 
Carriage Strobe (-) 
Print Wheel Strobe (-) 
Restore (-) 



Data Bit 1 
Data Bit 2 
Data Bit 3 
Data Bit 4 
Data Bit 5 
Data Bit 6 
Data Bit 7 



(1) (-) 

(2) <-) 
(4) (-) 
(8) (-) 
(16) (-) 
(32) (-) 
(64) (-) 



I Data Bit 8 (128) (-) 
I 

I Ribbon Lift (-) 
Select (-) 



*These eight input lines are pulled up to +5 volts by 180 Ohms and 
inverted. 

**In addition to being associated with bit-6 of the input port 
BASE, the Diablo Print Wheel Ready line (pin-27 of P5) is 
connected through an inverter to Interrupt Request line 6 (pin- 
24) of the 8259-A PIC. Thus, this line may be used to generate 
an interrupt whenever any external device brings it low (e.g., 
when the print wheel is ready) . 

The following lines on WB I/O connector P5 are tied to ground as 
described by Diablo interface standards: 

2, 8, 11, 14, 18, 20, 22, 25, 30, 31, 32, 35, 38, 41, 44, 47. 

(Line 24, defined by Diablo as Select (-), is also grounded.) 

Unimplemented (left floating) are lines 6, 7, 29, and 50. 
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Table 8-4: Printer Port P5 - Connector Pinouts 

Top View 
Back 

49 47 45 43 41 .. . 9 7 5 3 1 

Right Left 

50 48 46 44 42 ... 10 8 6 4 2 

Front 

8.1. Programming the Daisy-Wheel Printer Port 

As with all I/O devices on the WB I/O, the user must be careful 
when accessing the daisy-wheel printer port to initialize the 
correct I/O group - in this case, GROUP 0. Once the proper I/O 
group has been selected, all data output from the CPU to the 
parallel ports will be latched (if P5, pin-48 is at a high level) 
or ignored (if P5, pin-48 is grounded or allowed to float). 
Latched means the data output to a parallel port appears on the 
appropriate pins on the P5 connector, and remains there until 
either different data is output to the port in question or until 
pin-48 is floated or grounded. When pin-48 is grounded or 
allowed to float, all 17 parallel output pins of connector P5 
enter a high impedance state. 

The eight input lines from the daisy-wheel printer port are 
available to the CPU by reading BASE+0 (48h in standard 
configuration) with GROUP selected. When an input instruction 
is directed at daisy-wheel printer port 0, the CPU reads whatever 
data is on the appropriate lines of connector P5 at the time the 
instruction is executed. There is no provision for latching the 
daisy-wheel printer port input data because this data is buffered 
only. The input daisy-wheel printer port/pin assignments are 
listed in the tables beginning on page 27. 

The WB I/O daisy-wheel printer port inverts its input lines but 
does not invert its output lines. Daisy-wheel printers use 
negative logic: a low signal is taken as active. To activate any 
output line when talking to a daisy-wheel printer, the software 
must put the line low. Input lines from a daisy-wheel printer, 
on the other hand, are inverted in hardware, and so will appear 
to software to be active high. 
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8.2. Generating an Output Strobe 

Generating an output strobe off any of the parallel output ports 
on the WB I/O requires the use of a software mask. This means 
the line to be strobed must be output (at most) three times in 
succession, changing state each time, while the data lines 
associated with the same port be allowed to remain unchanged. 
For example, to output a strobe going high-low-high on bit-6 of 
port BASE without changing the other seven bits being output from 
that port, the following routine could be used: 

mvi a, data ; original data into register A 

ori 40h ; preserve data but bring bit-6 high 

out base ; output data with bit-6 high 

ani 0bfh ; preserve data but bring bit 6 low 

out base ; output data with bit-6 low 

ori 40h ; preserve data but bring bit 6 high 

out base ; output data with bit-6 high 



NOTE: GROUP port BASE+2 is shared with another 
device on the WB I/O — the real time clock. Be 
careful when outputting to this port. 

8.3. The Daisy-Wheel Printer Port and Interrupts 

The Print Wheel Ready status line of the daisy-wheel printer port 
(P5 connector, pin-27, BASE input port bit-5) is brought through 
an inverter to Interrupt Request line 6 of the 8259-A PIC. The 
PIC can generate an interrupt whenever this line goes to an 
active (i.e. logic low) state. To take full advantage of this 
interrupt option, the printer driver software should be written 
so that the Print Wheel Strobe (P5, pin-21, BASE output port bit- 
6) is not activated until all carriage positioning commands have 
first been sent to the printer. Print-after-space will execute 
significantly faster than space-after-print. When the Print 
Wheel Ready line goes active the printer should be able to accept 
another motion- then-print sequence. 

A sample Diablo printer driver, including source code for the WB 
I/O, can be obtained from Morrow Designs. 
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9. THE AUXILIARY PARALLEL PORT 

Besides the daisy-wheel printer port, the WB I/O contains an 

eight -bit, bi-directional parallel port with handshaking. The 

port is available at the DB15-S type connector P4 (location 12 
and 13E) on the PC board. 

Since the port has only a 15-pin connector, the data lines are 
bi-directional. The WB I/O and the external device time share 
the eight -bit bus. This means software must keep track of when 
the external device is trying to drive the eight lines to prevent 
both the WB I/O and the external parallel device from driving the 
lines simultaneously. 

The port is available by accessing (read or write) port BASE+3 of 
GROUP 0. There are two bits of status available from the 
external parallel device, FLAG1 and FLAG 2 . These two latched 
status lines, when high, indicate the external parallel device is 
ready to receive a character. Switch 7C determines which polarity 
the handshaking lines acknowledge. Switches are configured as 
follows : 

Table 9-1 : Parallel Port Switch Configuration 

S7 paddle 8 - ON if handshaking from the external parallel 

device is a positive-going strobe, OFF if it 
is a negative-going strobe. The output of 
this latch is referred to as FLAG1 and is 
high active. 

S7 paddle 7 - ON if handshaking from the external parallel 

device is a positive-going strobe, OFF if it 
is a negative-going strobe. The output of 
this latch is referred to as FLAG2 and is 
high active. 

The bits may be read from GROUP port BASE+1 as bits and 1 
respectively. Most parallel devices require the use of only one 
of these handshaking lines. These status lines are latched and 
cleared by software (output to BASE+6 with bit-1 low for FLAG1, 
bit-2 low for FLAG2). In addition to the two status flags, there 
are five port control lines available at BASE+6 of GROUP 0. 
These lines are configured as follows: 



33 



Bit 




Table 9-2: GROUP BASE+6 Output Port Assignment 
Active Signal name Description 



high 



low 



low 



low 



POE 



RST1 



RST2 



ATTN1* 



low 



ATTN2* 



Enable data from the WB I/O 
auxiliary parallel output 
port latch onto the bi- 
directional data bus on P4. 

Resets the handshaking latch 
(FLAG1) from the external 
device. 

Resets the handshaking latch 
(FLAG2) from the external 
device. 

This bit gets inverted when 
sent out to P4 to become a 
positive-going edge. This in- 
forms the external parallel 
device that the WB I/O has a 
character it wishes to send 
out to the external device. 

This bit gets inverted when 
sent out to P4 to become a 
positive going edge. This 
informs the external parallel 
device that the WB I/O has a 
character it wishes to send 
out to the external device. 



*Most parallel devices require only One attention line. 
The pinout of the 15-pin DB15-S connector is as follows 



Pin 

3 
7 
2 
6 
4 
8 
1 
5 

12 
13 

14 

15 



Polarity 


Name 


Positive 


Data 7 


Positive 


Data 6 


Positive 


Data 5 


Positive 


Data 4 


Positive 


Data 3 


Positive 


Data 2 


Positive 


Data 1 


Positive 


Data 


Positive 


ATTN1 


Positive 


ATTN2 


Switch 




selectable 

Qta7 *i 4* «~i Vi 


FLAG1 


owxT.cn 
selectable 


FLAG2 
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10. THE 1990 CALENDAR/CLOCK CHIP 

The 1990 CMOS crystal-controlled calendar/clock chip at location 
12A supports a real-time environment by providing two functions: 
1) a calendar clock accessible from software able to run off a 
battery, and 2) a timed interrupt generator able to provide real- 
time interval interrupts with three possible software 
programmable interval lengths. The clock uses six bits of port 
BASE+2, Select Line and Ribbon Lift Line of the daisy-wheel 
printer port. The chart below shows the WB I/O I/O ports and 
data bits used by the 1990, and indicates the correspondence 
between data bit and 1990 pin number/ function. 

Table 10-1: 1990 Calendar/Clock I/O Map 



I/O Port 
BASE+2 


BASE+2 
Bit # 


1990 Pin # 
& Mnemonic 


Input 







9 


- 


Data Ou 


to CPU: 


1 




10 


- 


TP 


Output 







6 


- 


Data In 


from CPU: 


1 




8 


- 


Clk 




2 




3 


- 


C0 




3 




2 


- 


CI 




4 




1 


- 


C2 




5 




4 


_ 


STB 



1990 Function 
Data Out Output of 40-bit shift register 
Timed pulse output 

Input of 40-bit shift register 
Shift clock for 40-bit register 
Command input bit-0 
Command input bit-1 
Command input bit-2 
Strobe input 
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Table 10-2: uPD1990C Pinout Definitions: 

Name Pin # Definition 

C2 1 Mode select pin. When high, this pin selects 

the time pulse output register. When low, 
this pin selects the calendar clock mode . 
This pin is set low to read or set the time 
and high to set the time pulse interrupt 
frequency. 

CI 2 This pin is used to select the time pulse 

interrupt if C2 is high or enable the shift 
register if C2 is low. 

C0 3 This pin is used to select the time pulse 

interrupt frequency if C2 is high. If C2 is 
low, and C0 is low, the contents of the shift 
register is written into the clock. If C0 is 
high and C2 is low, the clock contents are 
written into the shift registers for reading . 

STB 4 This line is used to strobe the contents of 

the C0 - C2 lines into the clock chip, 
for selecting the various command modes. 

CS 5 When high allows the CLK, STB and OE lines to 

reach the internal circuitry of the clock 
chip. Morrow Designs hardware ties this line 
high unless there is a system power failure. 

Data In 6 The serial data input to the chip allowing 

the clock's shift register to be altered for 
setting the clock. 

GND 7 Ground pin (0 volts) 

CLK 8 This pin is used to clock data into or out of 

the clock shift register. Data is clocked 
into the shift register on the rising edge of 
the clock. Data is clocked out of the shift 
register on the falling edge of the clock. 

Data Out 9 The serial data output line of the clock 

allowing contents of the shift register to be 
clocked into the system CPU. This data is 
available by reading bit-0 of WB I/O port 
BASE+2 . 

TP 10 Time pulse output provides interrupts at 

preset intervals. This output is available 
by reading bit-1 of WB I/O port BASE+2. 
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XTAL1 


12 


XTAL2 


13 


VDD 


14 



Table 10-2, Cont. 

OE 11 Output enable pin, when high, allows the TP 

and data out pins to be read. Morrow Designs 
hardware ties this pin high unless there is a 
system power failure. 

Crystal clock input (32.768 Khz). 

Crystal clock input (32.768 Khz). 

Power supply input (3.6 V max.). 

The C0 - C2 inputs can be summarized as follows: 

Function 

Register hold 

Register shift 

Write shift register 

into the clock 10 

Read the clock time 

intp shift register 11 



C2 


CI 


C0 













G 
R 








1 


O 

U 
P 







TP = 64 Hz 10 G 

R 

TP = 256 Hz 10 1 

U 

TP = 2048 Hz 110 P 

Test mode (32 Hz) 111 1 



10.1. Clock Initialization 

The clock powers up in the test mode. The TP output is clocking 
at 32 Hz. The clock TP pulse must be set to one of the three TP 
values before any clock Group (any command with C2 set low) 
command will execute. If at any time during operation the user 
sets the clock to 'Test Mode', he must again select one of the 
other TP values before attempting any clock Group commands. 
The test mode should NOT be considered as one of the possible 
timed interrupt values unless these peculiarities are 
acknowledged through software. 
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For a 64 Hz TP the power up sequence would look like: 

Set STB bit, C0 and CI bits low and C2 bit high 
(10h) and output to WB I/O port BASE+2. Then, 
with the C0 - C2 bits unchanged, set the STB bit 
high (30h) and output to WB I/O port BASE+2. 
Then, again with the C0 - C2 bits unchanged, 
set the STB bit low and output to WB I/O port 
BASE+2. From this point on, any one of the clock 
commands may be executed. 

Any command issued to the clock requires the STB bit to be low 
initially, then brought high and then low again with the data 
unchanged. This is all accomplished by manipulating bit-5 of 
port BASE+2. In order to write data into the shift register, the 
user first uses the Register Shift mode to enable the shift 
register (strobe-in with C0 high, CI and C2 low). Now data may 
be clocked into the shift register. After all the bits have been 
clocked into the shift register, the user then enters the Time 
Set mode (strobe-in with CI high, C0 and C2 low). This writes 
the contents just shifted into the shift register into the clock 
itself. Conversely, when reading the clock, the Time Read mode 
must be entered first (C0 and CI high, C2 low). This takes the 
clock's internal time and places it in the shift register. The 
data may then be clocked out from the shift register. 

10.2. Clock Programming 

The data sheets on the 1990 chip should be studied before 
attempting to program this device. The 1990 stores the time of 
day, day of week, and month of year in an internal 40-bit shift 
register which is accessible to the WB I/O user through bit-0 of 
I/O port BASE+2 of GROUP 0. Commands to set or read time must be 
strobed into this port using bit -4 as the strobe bit. The 40 bits 
of time data must be clocked in or out using bit-1 as the clock 
bit. The format of this internal 40-bit shift register is seven 
four-bit binary coded decimal nibbles and, for the month of the 
year, one hex nibble. The 40-bit shift register is a FIFO - 
first in, first out - the first being the Least Significant Bit 
(LSB). Thus, the first bit in or out is always the LSB of the 
single seconds nibble, and the last bit out is always the Most 
Significant Bit (MSB) of the month of the year nibble. 

Note in the following table how each individual nibble seems to 
coded backwards. 
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Table 10-3: Time Format of the 1990 40-Bit FIFO 

Bits 1 to 8 — Seconds (0 to 59) 

Seconds Units Tens of Seconds 

1990 bits 1234 5678 

LSB MSB LSB MSB 

Example; 38 seconds would be stored as follows: 

1990 bits 12 3 4 5 6 7 8 

Logic Level 0001 1100 

Interpretation: 8 3 

Bits 9 to 16 — Minutes (0 to 59) 
Minutes Units Tens of Minutes 

1990 bits 9 10 11 12 13 14 15 16 

LSB MSB LSB MSB 

Example: 41 minutes would be stored as follows: 

1990 bits 9 10 11 12 13 14 15 16 

Logic Level 1000 0010 

Interpretation: 1 4 

Bits 17 to 24 — Hours (0 to 23) 

Hours Units Tens of Hours 

1990 bits 17 18 19 20 21 22 23 24 
LSB MSB LSB MSB 

Example: 11 o'clock p.m. (2300 hours) would be stored as follows; 

1990 bits 17 18 19 20 21 22 23 24 

Logic Level 1100 0100 

Interpretation: 3 2 
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Table 10-3 Cont. 
Bits 25 to 32 — Day of Month (1 to 31) 
Day Units Tens of Days 



1990 bits 25 26 27 28 
LSB MSB 

Example: the 14th of the month 

1990 bits 25 26 27 28 



29 30 31 32 
LSB MSB 



29 30 31 32 



logic level 10 
Interpretation: 4 





1 







Bits 33 to 36 — Day of the Week (0 to 6) 



990 bits 


33 34 


35 


36 


Sunday 


= 




LSB 


MSB 


Garbage Bit 


Monday 
Tuesday 


ll ll 
to H 



Example: Thursday 
1990 bits 33 34 35 36 
Logic Level 10 
Interpretation: 4 



Saturday = 6 



Bits 37 to 40 — Month of the Year (0 to B Hex) 



1990 bits 37 38 39 40 

LSB MSB Garbage Bit 



Example: July 

1990 bits 37 38 39 40 



Logic Level 111 
Interpretation: 7 







January = 
February = 1 
March = 2 

• • • 

November = A Hex 
December = B Hex 
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10.3. Calendar Clock Idiosyncracies 

Once the 40-bit shift register of the 1990 has been set with the 
desired time and date, it automatically increments the time and 
date for later reference. Note, however, that the 1990 considers 
all months to have 31 days, so September, April, June and 
November - and certainly February - require a special update at 
the end of the month to keep the calendar current. 

10.4. Strobe and Clock Timing 

The 1990 is not capable of reading or writing serial data fast 
enough to keep up with the CPU unless the clock and strobe bits 
are prolonged for about 700 micro-seconds. This can be easily 
accomplished in software. 

10.5. Time/Date Software 

Writing the time to the 1990 requires a four step procedure: 

1: Select I/O GROUP of the WB I/O. 

2: Strobe the Register Shift Command to I/O port BASE+2. 
This is done outputting first a 04H, then a 24, then a 04H 
to port BASE+2 (but see note below). 

3: Clock forty consecutive bits to the data-in pin of the 
1990. Each bit is sent via three output instructions 
to I/O port BASE+2 with suitable delays in between. The 
the data-bit (bit-0) stays the same, the Strobe Bit (bit- 
5) stays low, and the Clock Bit (bit-1) is first low, 
then high, then low again (see note below). 

4: Strobe the Set Time Command to I/O port BASE+2. This is 
done by outputting first an 8H, then a 28H, then an 8H 
to port BASE+2 (see note below). 

NOTE: Bits 6 and 7 of WB I/O port BASE+2 of GROUP 
control the Ribbon Lift Line of the daisy-wheel 
printer port and the Printer Select Line. These bits 
should not be carelessly altered when outputting to 
the clock. 
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10.6. Software Flow for Reading the Time/Date 

Reading the time from the 1990 requires a four step procedure: 

1: Select I/O GROUP of the WB I/O. 

2: Strobe the Read Time Command to I/O port BASE+2 . This is 
done by outputting first a CH, then a 2CH, then a CH to 
port BASE+2 (see note on previous page). 

3: Strobe the Register Shift Command to I/O port BASE+2. 
This is done outputting first a 24H, then a 4, then a 24H 
to port BASE+2 ( see note on previous page . ) 

4: Clock forty consecutive bits from the data-out pin of the 
1990. Each bit is read via two output and one input 
instructions from I/O port BASE+2, with suitable delays 
in between, in which the Strobe Bit (bit-5) stays low, and 
the Clock Bit (bit-1) is first low, then high, then low 
again (see note on previous page). 

The appendix contains a source listing of a CP/M compatible 
program which can write the time to the 1990 clock or read it 
back . 

It is probably a good idea to have interrupts disabled when 
writing to or reading from the clock, since a lengthy interrupt 
service routine could cause the data read or written to be inac- 
curate. 

10.7. The Timed Interrupt Generator 

In addition to being a calendar/clock, the 1990 is capable of 
generating interrupts at timed intervals. The interrupts 
generated by the 1990 are routed to Interrupt Request number 7 of 
the 8259-A PIC. In order for these interrupts to be received 
properly, the PIC must be set to operate in level, rather than 
edge, mode. Three interval times are available and are selected 
under software control. The intervals are: 

1) Once every .488 milliseconds, or 2048 interrupts per second 

2) Once every 3.9 milliseconds, or 256 interrupts per second 

3) Once every 15.0 milliseconds, or 64 interrupts per second 
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10.8. Generating a Timed Interrupt 

As indicated in the data sheet on the 1990, the TP (Timed Pulse) 
output, which is the source of the 1990 interrupts, can be 
programmed to oscillate with a 50% duty cycle at one of three 
frequencies. These frequencies are selected by strobing the 
appropriate data into I/O port BASE+2. The data to be strobed 
out to the clock port and the corresponding oscillation frequency 
of the 1990 TP line are shown below: 

To set TP to the desired time, strobe the following bytes 
consecutively to I/O port BASE+2 of GROUP 0. (Note that the last 
column indicates time between interrupts.) 

Table 10-4: Setting the Timed Pulse 

Output string 

to BASE+2 TP Frequency Interrupts 

30H, 10H, 30H 64 Hz 15.0 msec 

31H, 11H, 31H 256 Hz 3.9 msec 

34H, 14H, 34H 2,048 Hz .488 msec 

NOTE: Bits 6 and 7 of I/O port BASE+2 of GROUP 
control the Ribbon Lift Line of the DAISY printer 
port and Printer Select Line. These bits should not 
be carelessly altered when outputting to the clock. 

10.9. Clearing the Timed Interrupts 

Any input instruction directed at I/O port BASE+2 clears the 
interrupt request generated by the 1990. This action does not 
involve the 1990 clock chip, but clears the flip-flop through 
which the 1990 TP output is latched and converted to a constant 
level before reaching the 8259-A PIC. The data obtained from 
this instruction may be ignored. 

10.10. A Good Random Bit 

The output of the 1990 TP has a 50% duty cycle; it is at a high 
logic state for the same length of time it is at a low logic 
state. The state of this line may be examined at any time by 
reading bit-1 of I/O port BASE+2 of GROUP 0, the same port used 
for reading and writing clock data. If examined immediately 
after the occurrence of a TP interrupt, the line will be high 
since it is the high-going edge of TP that generates the inter- 
rupt . 
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10.11. Generating Interrupts at Non-standard Intervals 

If the interval selection available on the 1990 does not fit the 
user's application, a broader selection is possible by using an 
on-board 8250 ACE - just program the ACE to generate an interrupt 
whenever the Transmitter Buffer is empty. 
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APPENDIX A 

SOME NOTES AND CAUTIONS 

In situations where one ISR is interrupted by another ISR, care 
should be taken to preserve CPU registers which might be altered, 
and so, sabotage the interrupted service routine. The same holds 
for routines that are time -dependent. They should be written to 
preserve their integrity in case they are interrupted. For 
example, if two routines use the same ACE device, it is possible 
for a routine to check, say, the TBE status bit, find the device 
to be ready, prepare to send data to the device, get interrupted, 
and proceed, when control is regained, to send data to a device 
that may no longer be ready. 

If the CPU sends an INTA pulse (an Interrupt Acknowledge) to the 
master PIC when no IRQ line on the PIC is asserted, the PIC will 
issue the CALL vector associated with IRQ7. It is very easy to 
induce this situation by grounding by hand the vectored interrupt 
lines . 

The CP/M * operating system contains a ultility program, DDT, 
which can be useful in developing software. This program has the 
provocative feature of enabling interrupts (issuing an EI 
command) whenever the "G" command is given. Under the right 
circumstances this can cause havoc if the user is caught unaware. 

The following page gives a graphic illustration of the program 
flow which occurs when a program is interrupted and the ISR which 
results is itself interrupted. 

*CP/M is a copyright of Digital Research 
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ILLUSTRATIONS OF PRIORITY INTERRUPT LEVELS 

Main program — > 

A1 > 

/ V 

/ \ 

/ \ 

/ \ 

/ \ 

/ \ 

■/. \ 

/ ISR A — > \ 

/ \ 

/— A2— A3-B1 A4 A5 

/ \ 

/ \ 

/ \ 

/ \ 

/ \ 

/ \ 

/ \ 

/ ISR B — > \ 

/ \ 

/ — B2 — B3 B4 B5 



Al: Main program is interrupted by Interrupt Request A and PIC 
vectors program off to Interrupt Service Routine A (ISR A). 

A2: ISR A removes the cause of its interrupt. 

A3: ISR A issues an EI (Enable Interrupts) command to the CPU. 
This permits the servicing of a HIGHER priority interrupt . 

Bl: IRQ B (Interrupt Request B), a higher priority than IRQ A, 
causes ISR A to be interrupted, and the PIC vectors the 
program OFF to ISR B. 

B2: ISR B removes the cause of its interrupt. 

B3: ISR B issues an EI command to the CPU. ISR B may now in 
turn be interrupted by a higher priority IRQ. 

B4: ISR B issues an EOI (End of Interrupt) command to the PIC. 
ISR B may be interrupted by SAME or LOWER priority IRQ. 

B5: ISR B exits its service routine with a RET instruction. 
Control returns to ISR A. 

A4: ISR A issues an EOI command to the PIC. 

A5: ISR A* exits its service routine with a RET instruction. 
Control returns to the main program. 
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APPENDIX B 

WB I/O CONNECTORS, SWITCHES AND JUMPER OPTIONS 

The following is a list of connectors, switch settings and jumper 
options and their function: 

The WB I/O board has the following I/O connectors available at 
the rear of the board. As viewed from the rear of the Decision 1 
cabinet they are left to right: 

Connector PC Location Function 

P4 12E - 13E Auxiliary 8-bit multi-purpose 

bi-directional parallel port. 

P5 8E - 12E Although not actually visible 

from the rear panel, this 50-pin 
header on the WB I/O is the 
connection for the daisy-wheel 
printer. 

P3 9E - 10E ACE Serial Device #3 - This port 

is usually reserved for printers 
in systems which require a serial 
printer. 

P2 6E - 7E ACE Serial Device #2 - normally 

the second CRT terminal port. 

PI 2E - 3E ACE Serial Device #1 - This port 

is the standard console I/O port 
for all Morrow Designs software. 

P6 1C Although not visible from the 

rear this connector is visible 
when the Decision 1 cover is 
open. This connector is the 
power input to the WB I/O. See 
table below for pin configura- 
tion. 



Pin Configuration - Power Input 

1 - + 16V 

2 - + 16V 

3 - + 8V 

4 - + 8V 

7 - ground 

8 - ground 

9 - ground 
10 - ground 
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Switch at board location 7C is used by Morrow Design's software 
to set the BASE port address, wait states and polarity of 
auxiliary parallel port handshaking inputs. The normal base 
address for all Morrow Designs software is 48 hex. The following 
summarizes this switch: 

Paddle Function 

1 ON causes the WB I/O to generate a wait state on 
I/O and Interrupt Acknowledged cycles during 
which the WB I/O has been selected. The ACE 
and PIC chips have a minimum access time of 250 
ns. Systems which require faster access times 
should have this switch ON. This switch is 
normally ON in Decision 1 systems. 

2 Maps to CPU address line A7 for address of BASE 
port (normally ON for Morrow Designs software). 

3 Maps to CPU address line A6 for address of BASE 
Port (normally OFF for Morrow Designs 
software) . 

4 Maps to CPU address line A5 for address of BASE 
port (normally ON for Morrow Designs software). 

5 Maps to CPU address line A4 for address of BASE 
port (normally ON for Morrow Designs software). 

6 Maps to CPU address line A3 for address of BASE 
port (normally OFF for Morrow Designs software). 

7 When OFF allows parallel handshake latch to 
respond to a strobe of negative polarity. 

8 When OFF allows parallel handshake latch to 
respond to a strobe of negative polarity. 



Switch at board location 10A is used to determine the baud rate 
for the on-board serial channels. The software reads these 
switches (at GROUP BASE+1 ) after a power-up or reset sequence 
and initializes the proper baud rates to perform the following: 
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Paddle Function 

1 Serial channels baud rate select 

normally ON 

2 Serial channels baud rate select 

normally ON 

3 Serial channels baud rate select 

normally ON 

4 Not yet dedicated 

5 Not yet dedicated 

6 Not yet dedicated 

7 Not connected 

8 Not connected 

The baud rates are determined as follows : 



ddle 1 


Paddle 2 


Paddle 3 


Baud rate 


OFF 


OFF 


OFF 


110 




OFF 


OFF 


ON 


300 




OFF 


ON 


OFF 


1200 




OFF 


ON 


ON 


2400 




ON 


OFF 


OFF 


4800 




ON 


OFF 


ON 


9600 


(default) 


ON 


ON 


OFF 


19200 




ON 


ON 


ON 


Automatic 
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Jumpers on the WB I/O Board 
Jumper Board location Function 

J1 8A IN causes the data read from the auxil- 

iary parallel port input latch (BASE+3 
of GROUP 0) to be latched into the 
auxiliary parallel port output latch 
(BASE+3 of GROUP 0). Normally this jumper 
is not installed. 

J2 8C Jumper between B and C of the WB I/O PIC 

is not a master and is not to respond to 
the CPU Interrupt Acknowledge signal . 
Jumper between A and B if the WB I/O is 
the master PIC and is to recognize the 
Interrupt Acknowledge line. This jumper 
is normally installed between A and B. 

J3 8C IN allows the INTR output of the PIC to 

drive the S-100 PINT line. This jumper 
must be IN if the WB I/O PIC is to be the 
master. If this PIC is a slave, the pad 
closest to chip 8C is connected to one of 
the S-100 VI lines at location 3C and the 
jumper is removed. This jumper is 
normally installed. Remove in systems 
where no interrupts are used. 

J 4 2C Selects which S-100 vectored interrupt 

line (if any) will be monitored by the 
PIC of the WB I/O. Pad A connects to PIC 
IRQ0 line. Pad B Connects to PIC IRQ1 
line. Pad C connects to PIC IRQ2 line. 
The pc etch has these lines hard wired to 
the VI0 - VI2 lines respectively so no 
jumpers are required for normal opera- 
tion. Pads are provided for user re- 
configuration if necessary. 

J5 13A Battery backup for the WB I/O on-board 

clock. A 3 - 5 volt source (5 V battery 
maximum) with 15 to 20K Ohm series 
resistors for circuit protection may be 
connected to J5 to supply power to the 
clock when AC power has been removed from 
the system. The connector is labeled for 
correct polarity, please take note. 

J6 8E RESET switch inputs to the WB I/O. 

Shorting switch across these pins causes 
RESET of the CPU board and most bus 
slaves. The front panel RESET switch of 
the Decision 1 connects to these lines. 
The factory configuration in brief: 
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Switch 7C Paddle: 

1 - ON 

2 - ON 

3 - OFF 

4 - ON 

5 - ON 

6 - OFF 

7 - OFF 

8 - OFF 

Switch 10A Paddle: 

1 - ON 

2 - ON 

3 - ON 

4 - ON 

5 - OFF 

6 - ON 

7 - OFF 

8 - OFF 

Jl Not installed 

J2 Jumpered A to B 

J3 Installed 

J4 No jumpers 

J5 Battery - user supplied 

J6 Connected to front panei reset 
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APPENDIX C 
TIME SET SOFTWARE 

The following program sets and reads the clock/calendar. The 
program runs under CP/M and assumes the I/O board to be addressed 
at I/O port 48h. 

To set the time using this program, type: 

TIME www MMM dd hh mm ss (pm/am) 

where www are the first three letters of the day, MMM are the 
first three letters of the month, dd are the decimal minutes of 
the hour and ss the decimal seconds of the minute. 

A twelve hour format may be used if either am or pm is typed at 

the end of the string. Otherwise data is assumed to be in 24 

hour format. Spaces should separate the data fields. Day of 

week and month of year may exceed three characters but only the 

first three are analyzed. Leading zeros may also be omitted as 
long as one character appears in the field in question. 

For example, typing: 

TIME MON NOV 17 7 30 AM 

would set the clock/calendar to Monday, November 17, 7:30:00 
a.m. 

To read the clock, simply type: 

TIME 
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SUBTTL *(c) Morrow Designs Inc.' 

Title 'Decision 1 Real-time Clock Software' 

* * 

* Time display/set program for Thinker Toys WBI/O board. * 

* * 

» Bobby Dale Gifford. * 

» 9/25/80 * 

* * 

* Revised for Decision I/O on 10/5/81 BJG * 

* * 

*X**«*«**»»*******«»****K********************»* ft***************** 



0000' 

000A 

0048 
004F 
004A 
0002 
0008 
000C 
0020 
0004 
0010 
0000 
0008 

0005 
0081 
0080 
0000 
000B 
0009 
0OOA 
0O0D 
000A 



rev 



aseg 



equ 



10 



0100 


2A 


0006 


0103 


F9 




0104 


CD 


03B6 


0107 


CA 


0261 



base 


equ 


48h 


grpsel 


equ 


base+7 


elk 


equ 


base+2 


clkclk 


equ 


2 


clkd 


equ 


8 


rclk 


equ 


Och 


cstb 


equ 


20h 


shft 


equ 


4 


tp64 


equ 


10h 


reghld 


equ 





wclk 


equ 


8 


bdos 


equ 


5 


cbuff 


equ 


81h 


clen 


equ 


8 Oh 


wboot 


equ 





const 


equ 


11 


pstr 


equ 


9 


readcon 


equ 


10 


acr 


equ 


Odh 


alf 


equ 


Oah 




org 


10Oh 


start: 


lhld 
sphl 


bdos+1 




call 


skipb 




jz 


display 



;Revision // x.x 

Base of Mult 1/0 ports 

Group select 

Clock port 

Clock elk bit 

Clock e1 bit 

Read clock command 

Clock strobe bit 

Shift bits command 

Output tick pulse at 64 hz 

Register hold command 

Write clock command 

Bdos entry point 
Command buffer string 
Command length byte 
Warm boot location 
Get constat function # 
Print string function # 
Read console buffer 
Carriage return 
Line feed 

{Transient program area 

;Set up stack 

;Skip command line blanks 
;No command line 
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010A 


21 


03F4 


010D 


CD 


0218 


0110 


CA 


0380 


0113 


11 


FCOC 


0116 


19 




0117 


7D 




0118 


37 




0119 


3F 




011A 


1F 




011B 


32 


03F3 


011E 


21 


044B 


0121 


CD 


0218 


0124 


CA 


0380 


0127 


11 


FBB5 


012A 


19 




012B 


7D 




012C 


37 




012D 


3F 




012E 


17 




012F 


17 




O130 


17 




0131 


47 




0132 


3A 


03F3 


0135 


BO 




0136 


32 


03F3 


0139 


CD 


01CE 


013C 


DA 


0380 


013F 


32 


03F2 


0142 


CD 


01CE 


0145 


DA 


0380 


0148 


32 


03F1 


014B 


CD 


01CE 


014E 


DA 


0380 


0151 


32 


03F0 


0154 


CD 


01CE 


0157 


DA 


0380 


015A 


32 


03EF 


015D 


CD 


03B6 


0160 


CA 


017B 


0163 


CD 


03D0 


0166 


FE 


50 


0168 


F5 




0169 


CC 


0395 


016C 


F1 





sett: 



lxi 

call 

jz 

lxi 

dad 

mov 

stc 

cmc 

rar 

sta 

lxi 

call 

jz 

lxi 

dad 

mov 

stc 

cmc 

ral 

ral 

ral 

mov 

Ida 

ora 

sta 

call 

jc 

sta 

call 

jc 

sta 

call 

jc 

sta 

call 

jc 

sta 

call 

jz 

call 

cpi 

push 

cz 

pop 



h,days 
match 3 
exit 
d,0 - 
d 
a,l 



wekmon 



days 



h, months 

match3 

exit 

d,0 - months 

d 

a,l 



b,a 

wekmon 

b 

wekmon 

bcd2 

exit 

date 

bcd2 

exit 

hour 

bed 2 

exit 

minutes 

bcd2 

exit 

seconds 

skipb 

noap 

scan ' 
.pi 

psw 

uphrs 

psw 



{Array of string pointers to match 
;Look for match 
;No match 
;Form index 

;Get low byte 
;Clear the carry 

; Divide index by 2 
;Day of week finished 

; Array of string pointers to match 
{Look for match 
{No match 
;Form index 

{Get low byte 
{Clear the carry 



{Save in B 

;0r in with day 



;Scan for two valid bed digits 

;New date 

;Scan for two more valid bed digits 

{New hour 

{Scan for two more valid bed digits 

;New minutes 

;Scan for last valid bed digits 

;New seconds 

;Skip trailing blanks 



{Check for AM or PM 
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016D 


FE 


41 


016F 


CC 


03A1 


0172 


CD 


03AC 


0175 


CD 


03B6 


0178 


C2 


0380 


017B 


3E 


00 


017D 


CD 


0360 


0180 


3E 


10 


0182 


CD 


0360 


0185 


11 


0513 


0188 


CD 


0389 


018B 


11 


0534 


018E 


0E 


OA 


0190 


CD 


0005 


0193 


CD 


01A2 


0196 


11 


04CE 


0199 


CD 


0389 


019C 


CD 


0276 


019F 


C3 


0000 



01A2 


AF 


01A3 


D3 4F 


01A5 


3E 04 


01A7 


CD 0360 


01AA 


E5 


01AB 


1E 08 


01AD 


23 


01AE 


7E 


01AF 


1F 


01B0 


77 


01B1 


17 


01B2 


E6 01 


01B4 


E3 


01B5 


B6 


01B6 


E3 


01B7 


CD 0346 


01BA 


I'D 


01BB 


C2 01AE 



noap: 



cpi 


•A' 


cz 


dwnhrs 


call 


skipc 


call 


skipb 


jnz 


exit 


mvi 


a.reghld 


call 


setup 


mvi 


a,tp64 


call 


setup 


lxi 


d.waltmsg 


call 


pmsg 


lxi 


d.ibuff 


mvi 


c,readcon 


call 


bdos 


call 


writec 


lxi 


d,acralf 


call 


pmsg 


call 


displ 1 


jmp 


wboot 



;If anything remaining, then error 
;Issue register hold command 
;Set up clock pulse 
;Wait for carriage return 
;Read console 

;Write the time 



;Display the current time 
;A11 done 



******* ********************************************************** 

* * 

* Writec does the actual clock time writing. This routine must * 

* not be interupted. 



_ r * 

* "*' * 



writec: 


xra 


a 




out 


grpsel 




mvi 


a.shft 




call 


setup 




push 


h 


wbyte: 


mvi 


e,8 




inx 


h 


wbit: 


mov 
rar 


a,m 




mov 


m,a 




ral 






ani 


1 




xthl 






ora 


m 




xthl 






call 


clkstb 




dcr 


e 




jnz 


wbit 



;Select group 

; Shift command 

Save clock data address 

Bit shift counter 

Bump to next byte of data 

Get current byte of data 

LSB into carry 

Save current byte 

Carry into LSB 

Through away useless bits 

Recover address of clock data 

Get current state 

Recover current byte counter 

Strobe in one bit 

Update bit counter 

Same byte ? 
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01BE 


15 




01BF 


C2 


01AB 


01C2 


E1 




01C3 


7E 




01C4 


F6 


08 


01C6 


CD 


0344 


01C9 


EE 


08 


OTCB 


C3 


0344 



01CE 


CD 


03B6 


01D1 


CD 


03D0 


01D4 


37 




01D5 


C8 




01D6 


FE 


3A 


01D8 


CA 


01CE 


01DB 


FE 


2C 


01DD 


CA 


01CE 


01E0 


CD 


020E 


01E3 


D8 




01E4 


47 




01E5 


CD 


03D0 


01E8 


CA 


020A 


01EB 


FE 


2C 


01ED 


CA 


020A 


01F0 


FE 


20 


01F2 


CA 


020A 


01F5 


FE 


3A 


01F7 


CA 


020A 


01FA 


CD 


020E 


01FD 


D8 




01FE 


37 




01FF 


3F 




0200 


F5 




0201 


78 




0202 


17 




0203 


17 




0204 


17 




0205 


17 




0206 


47 





dcr 

jnz 

pop 

mov 

ori 

call 

xri 



d 

wbyte 

h 

a,m 

wclk 

clkcmd 

wclk 

clkcmd 



; Update bye counter 

;A11 done ? 

;Recover address of clock data 

;Get current state 

;Set write clock bit 

; Issue write time command 

;Turn off write time command 



» * 

* Bcd2 scans the command line for up to two valid ascii digits * 

* and returns the result as a packed bed byte in reg A. * 
« * 
************************* *««*«««****»«*»»***«*«« ******* ********** 



bcd2: 



call 


skipb 


call 


scan 


stc 




rz 




cpi 


i • t 


jz 


bcd2 


cpi 


i ? 

r 


jz 


bcd2 


call 


digit 


re 




mov 


b,a 


call 


scan 


jz 


okd 


cpi 


t i 
> 


jz 


okd 


cpi 


i i 


jz 


okd 


cpi 


1 • 1 


jz 


okd 


call 


digit 


re 




stc 




cmc 




push 


psw 


mov 


a,b 


ral 




ral 




ral 




ral 




mov 


b.a 



;Skip any preceeding blanks 
;Get first char of day of month 
;Carry is error 



;Check for valid decimal digit 
;Save in B 

;Check for end of day of month 



;Clear the carry 
;Save low nibble 
;Put previous digit into high nibble 

;Save in B 
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0207 


F1 


0208 


BO 


0209 


47 


020A 


78 


020B 


37 


020C 


3F 


020D 


C9 



020E 


FE 


30 


0210 


D8 




0211 


FE 


3A 


0213 


3F 




0214 


D8 




0215 


D6 


30 


0217 


C9 





0218 


3E 


03 


021A 


32 


0542 


021D 


5E 




021E 


23 




021F 


56 




0220 


23 




0221 


7B 




0222 


B2 




0223 


C8 




0224 


E5 




0225 


2A 


0540 


0228 


E5 




0229 


3A 


0080 


022C 


F5 




022D 


CD 


03D0 


0230 


CA 


0255 


0233 


CD 


03E5 



;Recover low digit 
;Form byte 
;Save in B 

;Recover day of month 
;No error 



XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

x » 

* Digit checks if the char in reg A is a valid ascii digit. * 
x x 

»xxx****x«*x***x**x*******x**K*****xx*x»xx«xxxxxx*x*««*****xx»x** 





pop 


psw 




ora 


b 




mov 


b,a 


okd: 


mov 
ste 
cmc 
ret 


a,b 



digit: cpi 
re 
cpi 
cmc 
re 
sui 
ret 



•0' 
'9'+1 



;Less than 
; Greater than 9 

;Strip off ascii bias 



XXXXX«XXX*X*****XXXXXXXXXXX*XXXXXX*XX*XXX*XX*X*XX«ft**X**tt****XX*X 

x x 

* Match3 guarentees that at least three characters are matched * 

* with the command line. * 
x x 

XKXXXXXXXXXXXXXXXXXXKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 



;Clear match count 

;Get current string pointer 



match3: 


mvi 


a,3 




sta 


ment 




mov 


e,m 




inx 


h 




mov 


d,m 




inx 


h 




mov 


a,e 




ora 


d 




rz 






push 
lhld 
push 
Ida 


h 

scanpnt 
h 
clen 


mtchmo: 


push 
call 


psw 
scan 




jz 


nomatch 




call 


toupper 



;Check if all done 

;No match 

;Save current array pointer 

;Save current scan pointer 

;Save current command length 

;Scan and convert to upper case 
:No match if out of chars 



'Decision 1 Real-time Clock Software' 
'(c) Morrow Designs Inc.' 



MACRO-80 3.36 17-0ct-81 



PAGE 



1-5 



0236 


47 


0237 


1A 


0238 


13 


0239 


CD 03E5 


023C 


B8 


023D 


C2 0255 


0240 


3A 0542 


0243 


3D 


0244 


32 0542 


0247 


C2 022D 


024A 


CD 03AC 


024D 


E1 


024E 


E1 


024F 


E1 


0250 


2B 


0251 


2B 


0252 


CO 


0253 


3C 


0254 


C9 


0255 




0255 


F1 


0256 


32 0080 


0259 


E1 


025A 


22 0540 


025D 


E1 


025E 


C3 0218 



nomatch: 



mov 

ldax 

inx 

call 

cmp 

jnz 

Ida 

dcr 

sta 

jnz 

call 

pop 

pop 

pop 

dcx 

dcx 

rnz 

inr 

ret 

pop 

sta 

pop 

shld 

pop 

jmp 



b, a 

d 

d 

toupper 

b 

nomatch 

mcnt 

a 

mcnt 

mtchmo 

skipc 

h 

h 

h 

h 

h 



psw 

clen 

h 

scanpnt 

h 

match3 



Save in B 

Get next char in string 

Bump string pointer 

Convert to upper case 

Does it match ? 

Mo match 

Get match count 

Matched three ? 

Save match count 

Match more ? 

Skip rest of characters 

Through away old scan pointer 

Through away old command length 

Recover array pointer 

Backup array pointer 

;No error return 
;No error return 



;Recover command length 
; Restore command length 
;Recover scan pointer 
;Restore scan pointer 
;Recover array pointer 
;Try again 



ft**************************************************************** 

» * 

» Display continually displays the time as long as nothing is * 

* typed on the console. * 

* * 



0261 






0261 


CD 


0276 


0264 


0E 


0B 


0266 


CD 


0005 


0269 


A7 




026 A 


C2 


0000 


026D 


11 


04CC 


0270 


CD 


0389 


0273 


C3 


0261 



display: 




call 


displ 1 


mvi 


c, const 


call 


bdos 


ana 


a 


jnz 


wboot 


lxi 


d,acrmsg 


call 


pmsg 


jmp 


display 



;Display one time line 
;Check console for char 

;If anything typed then reboot 

;Print carriage return only 

;Go print the time again 



;#*#»»#*»»***#*##***«**########*»##*####**»»###«*)(»##»****,(**»»,(*), 
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0276 


CD 031B 


0279 


3A 03F3 


027C 


E6 07 


027E 


17 


027F 


5F 


0280 


16 00 


0282 


21 03F4 


0285 


19 


0286 


5E 


0287 


23 


0288 


56 


0289 


7B 


028A 


B2 


028B 


CA 0276 


028E 


CD 0389 


0291 


3A 03F3 


0294 


1F 


0295 


IF 


0296 


1F 


0297 


E6 1E 


0299 


5F 


029A 


16 00 


029C 


21 044B 


029F 


19 


02A0 


5E 


02A1 


23 


02A2 


56 


02A3 


7A 


02A4 


B3 


02A5 


CA 0276 


02A8 


CD 0389 


02AB 


21 04D1 


02AE 


E5 


02AF 


3A 03F2 


02B2 


1F 


02B3 


1F 


02B4 


1F 


02B5 


1F 


02B6 


E6 OF 



* Displl displays the current time once. * 

* # 

**X*******«*«*»*«***««*«********X***********X*«*»********»»****ft* 



;Read the clock - watch out if interupts are on 
;Get the day of the week 
.•Through away irrelevent bits 
;Multiply by 2 
;Form 16 bit offset 

;Array of string pointers 

;Form absolute address of string 

;Get low string address byte 

; Point to high byte 

;Get high byte 

;Check for invalid day 



displl: call 


readc 


Ida 


wekmon 


ani 


7 


okday: ral 




mov 


e,a 


mvi 


d,0 


lxi 


h.days 


dad 


d 


mov 


e,m 


inx 


h 


mov 


d,m 


mov 


a,e 


ora 


d 


jz 


displ 1 


call 


pmsg 


Ida 


wekmon 


rar 




rar 




rar 




ani 


1eh 


mov 


e,a 


mvi 


d,0 


lxi 


h, months 


dad 


d 


mov 


e,m 


inx 


h 


mov 


d,m 


mov 


a,d 


ora 


e 


jz 


displ 1 


call 


pmsg 


lxi 


h,tbuff 


push 


h 


Ida 


date 


rar 




rar 




rar 




rar 




ani 


Ofh 



;Start over again if invalid 
;Print the day 

;Get the month 

;Adjust for proper offset 



Multiply by two and through out 

irrelevent bits 
Form 16 bit offset 

;Array of string pointers 

;Form absolute address of string 

;Get low string address byte 

; Point to high byte 

;Get high byte 

;Check for invalid month 

;Start over again if invalid 
;Print the month 

; Pointer to temporary storage 
;Save for printing 
;Convert the date to ascii 
;Get high digit into low nibble 
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02B8 


C4 


0379 


02BB 


3A 


03F2 


02BE 


CD 


0379 


02C1 


3E 


2C 


02C3 


CD 


037D 


02C6 


3E 


20 


02C8 


CD 


037D 


02CB 


3A 


03F1 


02CE 


FE 


13 


02D0 


D4 


038E 


02D3 


B7 




02D4 


CC 


0392 


02D7 


CD 


0370 


02DA 


3E 


3A 


02DC 


CD 


037D 


02DF 


3A 


03F0 


02E2 


CD 


0370 


02E5 


3E 


3A 


02E7 


CD 


037D 


02EA 


3A 


03EF 


02ED 


CD 


0370 


02F0 


3E 


20 


02F2 


CD 


037D 


02F5 


3A 


03F1 


02F8 


FE 


12 


02FA 


3E 


61 


02FC 


DA 


0301 


02FF 


3E 


70 


0301 


CD 


037D 


0301 


3E 


6D 


0306 


CD 


037D 


0309 


7E 




030A 


FE 


24 


030C 


CA 


0317 


030F 


3E 


20 


0311 


CD 


037D 


0311 


C3 


0309 


0317 


D1 




0318 


C3 


0389 



;Don'T print leading zero 
;Get the low digit 
;Stuff it in the buffer 
;And the comma and space 



;Get the hour 

; Check for AM or PM 

;Convert PM from 13-24 into 0-12 

;Check for 12 midnight 

;Put both digits into the buffer 
;Put the colon in the buffer 

;Get the minutes 

;Put both minutes digits in the buffer 

;Put another colon in the buffer 

;Get the seconds 

;Put both second digits in the buffer 

;One space into the buffer 

; Check hours for AM or PM 

;Print 'A' or 'P' 



;Put the 'A' or »P' in the buffer 
;Put the 'M* in the buffer 

;Get the next char in the buffer 

;Is it the end ? 

;A11 done 

;Get a space 

;Put it in the buffer 

;Finishing padding with spaces 

;Recover the Buffer address 
; Print the buffer 

******** ****«**«***«***««•**»*****» ****************************** 

* « 

* Readc does the actual clock reading (40 bits) from the * 

* hardware. If interupts are enabled, then care must be taken * 





cnz 


putlow 




Ida 


date 




call 


putlow 




mvi 


a ' ' 




call 


put 




mvi 


a,' • 




call 


put 




Ida 


hour 




cpi 


13h 




cnc 


subhr 




ora 


a 




cz 


mak12 




call 


puthi 




mvi 


a,':' 




call 


put 




Ida 


minutes 




call 


puthi 




mvi 


a 1 • 1 

a, . 




call 


put 




Ida 


seconds 




call 


puthi 




mvi 


a,' • 




call 


put 




Ida 


hour 




cpi 


12h 




mvi 


a, 'a* 




jc 


isam 




mvi 


a.'p' 


isam: 


call 


put 




mvi 


a, 'm' 




call 


put 


sploop: 


mov 


a,m 




cpi 


'$' 




jz 


endsp 




mvi 


a,* ' 




call 


put 




jmp 


sploop 


endsp: 


pop 


d 




jmp 


pmsg 
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;* to assure that this routine is not interupted until it * 
;* completes. * 

■ * * 

■*****«***««*»*****»**************x******»»***«***»***x*«********* 



031B 


AF 


031c 


D3 4F 


031E 


3E 0C 


0320 


CD 0360 


0323 


E5 


0324 


EE 08 


0326 


CD 0344 


0329 


1E 08 


032B 


23 


032C 


AF 


032D 


D3 4F 


032F 


DB 4A 


0331 


1F 


0332 


7E 


0333 


1F 


0334 


77 


0335 


E3 


0336 


7E 


0337 


E3 


0338 


CD 0346 


033B 


1D 


033C 


C2 032C 


033F 


15 


0340 


C2 0329 


0343 


E1 


0344 


0E 20 


0346 


F5 


0347 


3E 00 


0349 


D3 4F 


034B 


F1 


034C 


D3 4A 


034E 


CD 0369 


0351 


A9 


0352 


D3 4A 


0354 


CD 0369 


0357 


A9 


0358 


D3 4A 


035A 


CD 0369 


035D 


0E 02 


035F 


C9 



readc: 


xra 


a 




out 


grpsel 




mvi 


a, rclk 




call 


setup 




push 


h 




xri 


clkd 




call 


clkcmd 


rbyte: 


mvi 


e,8 




inx 


h 


rbit: 


xra 


a 




out 


grpsel 




in 


elk 




rar 






mov 


a,m 




rar 






mov 


m,a 




xthl 






mov 


a,m 




xthl 






call 


clkstb 




dcr 


e 




jnz 


rbit 




dcr 


d 




jnz 


rbyte 




pop 


h 


clkcmd: 


mvi 


c,cstb 


clkstb: 


push 


af 




mvi 


a,0 




out 


grpsel 




pop 


af 




out 


elk 




call 


delay 




xra 


c 




out 


elk 




call 


delay 




xra 


c 




out 


elk 




call 


delay 




mvi 


c,clkclk 




ret 





;Select group zero 

;Read clock into 40 bit shift register 

;Save address of elkdata 
; Issue shift command 

;Prep for 8 bits 

;Bump to next address of clock data 



Read one bi 
Put bit int 
Get partial 
Shift in th 
Save partia 
Get address 
Get clock d 
Save addres 
Strobe the 
All done wi 
Read anothe 
Completely 
Read anothe 
Recover add 
Get clock s 



o carry 

ly assembled byte 
e bit just read 
lly assembled byte 

of elkdata 
ata 

s of clock data 
shift register 
th this byte ? 
r bit if not 
done ? 

r byte if not 
ress of elkdata 
trobe bit 



low 



;0utput strobe low 

;Wait for chip to see the strobe 

;Turn strobe high 

;0utput strobe high 

;Wait for chip to see the strobe high 

;Turn strobe low 

[Output strobe low 

;Clock elk bit 
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0360 


16 


05 


0362 


21 


03EE 


0365 


B6 




0366 


C3 


0344 


0369 


06 


01 


036B 


05 




036C 


C2 


036B 


036F 


C9 





0370 


F5 


0371 


1F 


0372 


1F 


0373 


1F 


0374 


1F 


0375 


CD 0379 


0378 


F1 


0379 


E6 OF 


037B 


C6 30 


037D 


77 


037E 


23 


037F 


C9 



0380 


11 


04F9 


0383 


CD 


0389 


0386 


C3 


0000 



;Count of bytes to read 
;Address of clock data 
;Get current bit state 
; Issue the command 

;Time delay 



******* *********************** *****»»****»*** **»***»»********»*»* 

* * 

* Puthi puts the high and low nibbles of the bed number in * 

* the a reg in the temporary buffer. * 
« « 
***************************************************************** 



setup: 


mvi 


d,5 




lxi 


h,clkdata 




ora 


m 




jmp 


elkemd 


delay: 


mvi 


b,1 


delayl : 


dcr 


b 




jnz 


delayl 




ret 





puthi: 


push 

rar 

rar 

rar 

rar 


psw 




call 


putlow 




pop 


psw 


putlow: 


ani 


Ofh 




adi 


•0' 


put: 


mov 


m,a 




inx 


h 




ret 





;Save low nibble 

;Put high nibble into low nibble 



;Print the low nibble of a reg 
;Recover the low nibble 
;Strip off irrelevent bits 
;Form Ascii character 
;Put char in buffer 
;Bump buffer pointer 



a**************************************************************** 
« * 

* Exit is the standard error message for invalid command. * 

* * 
********«******«•*»* *********************************** ********** 



exit: 



***************************************************************** 

* * 

* Pmsg is the CP/M print string function. * 
» * 
it**************************************************************** 



lxi 


d,badtmsg 


call 


pmsg 


jmp 


wboot 
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0389 


0E 


09 


038B 


C3 


0005 


038E 


C6 


88 


0390 


27 




0391 


C9 




0392 


3E 


12 


0394 


C9 




0395 


3A 


03F1 


0398 


FE 


12 


039A 


C8 




039B 


C6 


12 


039D 


32 


03F1 


03A0 


C9 




03A1 


3A 


03F1 


03A4 


FE 


12 


03A6 


CO 




03A7 


AF 




03A8 


32 


03F1 


03AB 


C9 




03AC 


CD 


03D0 


03AF 


C8 




03B0 


FE 


20 


03B2 


C2 


03AC 


03B5 


C9 




03B6 


CD 


03D0 


03B9 


C8 




03BA 


FE 


20 


03BC 


CA 


03B6 


03BF 


E5 




03C0 


2A 


0540 


03C3 


2B 




03C1 


22 


0540 


03C7 


3A 


0080 


03CA 


3C 




03CB 


32 


0080 


03CE 


El 




03CF 


C9 





03D0 



3A 0080 



pmsg: 


mvi 


c, pstr 




jmp 


bdos 


subhr: 


adi 
daa 
ret 


88h 


mak12: 


mvi 
ret 


a, 12h 


uphrs: 


Ida 


hour 




cpi 


12h 




rz 






adi 


12h 




sta 


hour 




ret 




dwnhrs: 


Ida 


hour 




cpi 


12h 




rnz 






xra 


a 




sta 


hour 




ret 




skipc : 


call 

rz 

cpi 


scan 
i i 




jnz 


skipc 




ret 




skipb: 


call 

rz 

cpi 


scan 




jz 


skipb 


unscan: 


push 


h 




lhld 


scanpnt 




dcx 


h 




shld 


scanpnt 




Ida 


clen 




inr 


a 




sta 


clen 




pop 


h 




ret 




scan: 


Ida 


clen 



;Subhr adjusts the BCD number to 
: be between 1 and 12 



;Get next char 
;Return if no more chars 
; Check for space 
;Continue if not 



Get next char 

Return if no characters left 

Is it a space 

Skip it 

Save HL 

Get command scan pointer 

Back it up 

Save updated char 

Update length 

;Save updated length 
;Restore HL 



;Check if anything left 
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03D3 


A7 


03D4 


C8 


03D5 


3D 


03D6 


32 0080 


03D9 


E5 


03DA 


2A 0540 


03DD 


7E 


03DE 


23 


03DF 


22 0510 


03E2 


E1 


03E3 


B7 


03E4 


C9 


03E5 




03E5 


FE 61 


03E7 


D8 


03E8 


FE 7B 


03EA 


DO 


03EB 


D6 20 


03ED 


C9 



03EE 




03EE 


00 


03EF 




03EF 


00 


03F0 




03FO 


00 


03F1 


00 


03F2 


00 


03F3 


00 



03F4 
03F6 



0404 
040D 





ana 


a 




rz 






dcr 


a 




sta 


clen 




push 


h 




lhld 


scanpnt 




mov 


a,m 




inx 


h 




shld 


scanpnt 




pop 


h 




ora 


a 




ret 




toupper 


: 






cpi 


•a» 




re 






cpi 


'z' + 1 




rnc 






sui 


i t 




ret 





jReturn with Z set if no more 
; Update length 

;Save HL 

;Get command pointer 

; Update command pointer 
;Clear Z flag 

;Is it lower case ? 



***************************************************************** 
* 



* The following are data used within the program. 



* 
« 

ft********************** ****»*« ******** ****»»»**»»**** ***** ******* 

elkdata: 

;Current state of elk port 

;Seconds read 

;Minutes read 

;Hours read 

;Date read 

;Week day and month read 

**************************************** *************** ****«****# 

* » 

* Days is an array of pointers to strings, used to print the * 

* english version of the day of the week. * 

* * 
**#********************#**********##**********»****************** 





db 





seconds 








'db 





minutes 








db 





hour: 


db 





date: 


db 





wekmon: 


db 






days; 



dw 
dw 



sun 
mon 
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03F8 


0416 






03FA 


0420 






03FC 


042C 






03FE 


0437 






0400 


0440 






0402 


0000 






0404 


53 


75 


6E 


64 


0408 


61 


79 


2C 


20 


040C 


24 








040D 


4D 


6F 


6E 


64 


0411 


61 


79 


2C 


20 


0415 


24 








0416 


54 


75 


65 


73 


041A 


64 


61 


79 


2C 


041E 


20 


24 






0420 


57 


65 


64 


6E 


0424 


65 


73 


64 


61 


0428 


79 


2C 


20 


24 


042C 


54 


68 


75 


72 


0430 


73 


64 


61 


79 


0434 


2C 


20 


24 




0437 


46 


72 


69 


64 


043B 


61 


79 


2C 


20 


043F 


24 








0440 


53 


61 


74 


75 


0444 


72 


64 


61 


79 


0448 


2C 


20 


24 







dw 




dw 




dw 




dw 




dw 




dw 


sun: 


db 


mon: 


db 


tue: 


db 


wed: 


db 


thu: 


db 


fri: 


db 


sat: 


db 



tue 


wed 


thu 


fri 


sat 





•Sunday, $' 


'Monday, $' 


'Tuesday, $' 


'Wednesday, $' 


'Thursday, $' 


'Friday, $' 


'Saturday, $' 



;Illegal day 



*******»********K****S**«******«***»*»*******tt*******«*»******«*K 

* * 

* Months is an array of pointers to strings, used to print the * 

* english version of the month of the year. * 

* * 



044B 


046B 


044D 


0474 


044F 


047D 


0451 


0484 


0453 


048B 


0455 


0490 


0457 


0496 


0459 


049C 


045B 


04A4 


045D 


04AF 



months: dw 


jan 


dw 


feb 


dw 


mar 


dw 


apr 


dw 


may 


dw 


jun 


dw 


Jul 


dw 


aug 


dw 


sep 


dw 


oct 
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015F 


01B8 


0461 


01C2 


0163 


0000 0000 


0467 


0000 0000 


046B 


4A 


61 6E 75 


046F 


61 


72 79 20 


0173 


21 




0171 


16 


65 62 75 


0178 


61 


72 79 20 


017C 


24 




017D 


4D 


61 72 63 


0481 


68 


20 24 


0481 


41 


70 72 69 


0188 


6C 


20 24 


018B 


4D 


61 79 20 


048F 


24 




0490 


4A 


75 6E 65 


0194 


20 


24 


0496 


4A 


75 6C 79 


049A 


20 


24 


049C 


41 


75 67 75 


04A0 


73 


74 20 24 


04A4 


53 


65 70 74 


04A8 


65 


6D 62 65 


04AC 


72 


20 21 


04AF 


4F 


63 71 6F 


04B3 


62 


65 72 20 


04B7 


24 




01B8 


4E 


6F 76 65 


04BC 


6D 


62 65 72 


04C0 


20 


21 


04C2 


44 


65 63 65 


04C6 


6D 


62 65 72 


04CA 


20 


21 


04CC 


0D 


21 


01CE 


0D 


0A 21 





dw 




dw 




dw 


jan: 


db 


feb: 


db 


mar: 


db 


apr : 


db 


may: 


db 


jun: 


db 


Jul: 


db 


aug: 


db 


sep: 


db 



oct: 



nov: 



dec: 



acrmsg: db 
acralf: db 
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nov 
dec 
0,0,0,0 



•January $' 

'Febuary $' 

•March $• 
'April $' 
•May $' 
'June $' 
'July $• 
'August $' 
'September $' 

'October $' 

'November $' 

'December $' 



acr, '$' 
acr ,alf , '$' 
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db 



db 



db 



; Illegal months 



01D1 



30 30 2C 20 



»#*»*****«»*#*»**»«***##*«*»#***#*********»****, ************ * **** 
» * 

* Tbuff is used to prepare the day of the month, hours, minutes,* 

* and seconds prior to printing. * 

* * 
*****X********N*******X****N ************************************* 

tbuff: db '00, 00:00:00 am $' 
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04D5 


30 


30 


3A 


30 




04D9 


30 


3A 


30 


30 




04DD 


20 


61 


6D 


20 




04E1 


20 


20 


20 


20 




04E5 


20 


20 


20 


20 




04E9 


20 


20 


20 


20 




04ED 


20 


20 


20 


20 




04F1 


20 


20 


20 


20 




04F5 


20 


20 


20 


24 




04F9 










badtmsg: 


04F9 


0D 


OA 






db 


04FB 


49 


6E 


76 


61 


db 


04FF 


6C 


69 


64 


20 




0503 


54 


69 


6D 


65 




0507 


20 


73 


70 


65 




050B 


63 


69 


66 


69 




050F 


65 


64 


2E 


24 




0513 










waitmsg: 


0513 


OD 


OA 






db 


0515 


50 


72 


65 


73 


db 


0519 


73 


20 


72 


65 




051D 


74 


75 


72 


6E 




0521 


20 


74 


6F 


20 




0525 


73 


65 


74 


20 




0529 


74 


68 


65 


20 




052D 


74 


69 


6D 


65 




0531 


3A 


20 


24 






0534 


OA 


OA 






ibuff: db 


0536 










ds 


0540 










scanpnt: 


0540 


0081 






dw 


0542 


00 








mcnt: db 



acr.alf 

'Invalid Time specified. $' 



acr ,alf 

•Press return to set the time: $' 



10, 10 
10 



cbuff 




end 



15 



'Decision 1 Real-time Clock Software' 
'(c) Morrow Designs Inc.* 



MACRO-80 3.36 17-Oct-81 



PAGE 



Macros: 



Symbols 


: 














ACR 


000D 


ACRALF 


04CE 


ACRMSG 


04CC 


ALF 


OOOA 


APR 


0484 


AUG 


049C 


BADTMS 


04F9 


BASE 


0048 


BCD2 


01CE 


BDOS 


0005 


CBUFF 


0081 


CLEN 


0080 


CLK 


004A 


CLKC1 


0008 


CLKCLK 


0002 


CLKCMD 


0344 


CLKDAT 


03EE 


CLKSTB 


0346 


CONST 


000B 


CSTB 


0020 


DATE 


03F2 


DAYS 


03F4 


DEC 


04C2 


DELAY 


0369 


DELAY 1 


036B 


DIGIT 


020E 


DISPL1 


0276 


DISPLA 


0261 


DWNHRS 


03A1 


ENDSP 


0317 


EXIT 


0380 


FEB 


0474 


FRI 


0437 


GRPSEL 


004F 


HOUR 


03F1 


IBUFF 


0534 


ISAM 


0301 


JAN 


046B 


JUL 


0496 


JUN 


0490 


MAK12 


0392 


MAR 


047D 


MATCH3 


0218 
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PARTS LIST 



3 8-pin low profile sockets 

19 14-pin low profile sockets 

6 16-pin low profile sockets 
10 20-pin low profile sockets 

1 28-pin low profile sockets 

3 40-pin low profile sockets 

2 3/4 inch wide heat sink 

4 6-32 hex machine nuts 

4 6-32 x 3/8 machine screws 

1 10-pin power connector 

1 2 -pin reset connector 

1 50-pin hooded dual inline connector 

3 26-pin right angle P.C. mount (subminiature D connectors) 

1 15-pin right angle P.C. mount (subminiature D connectors) 
14 100-pin S-100 edge connectors 

2 8 position DIP switch arrays 

2 2 position .025 square connector post array 

1 3 position .025 square connector post array 

1 3.3 Ohm 1/4 watt resistor 

2 75 Ohm 1/4 watt resistors 
2 130 Ohm 1/4 watt resistors 
2 220 Ohm 1/4 watt resistors 
2 330 Ohm 1/4 watt resistors 
1 360 Ohm 1/4 watt resistor 

1 390 Ohm 1/4 watt resistor 

2 1.5k Ohm 1/4 watt resistors 
8 3.3k Ohm 1/4 watt resistors 

4 4.7k Ohm 1/4 watt resistors 

1 10k Ohm 1/4 watt resistor 

3 100k Ohm 1/4 watt resistor 

7 100k Ohm 1/8 watt resistor 

12 10-pin 180 Ohm SIP resistor array 

2 8-pin 3.3k Ohm SIP resistor array 

2 20 pf dipped mica capacitor 

1 47 pf dipped mica capacitor 

1 56 pf dipped mica capacitor 

1 112 pf dipped mica capacitor 

7 dipped tantalum capacitor - 20V 

4 39 ufd axial tantulum 10V capacitor 
22 disk ceramic by-pass capacitor 



1 32.768 KHz clock crystal 
1 18.432 MHz HU/18 crystal 
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PARTS LIST CONT. 

1 IN914 signal diode 

1 IN5221 2.6V zener diode 



2 2N3904 NPN transistor 

3 2N3906 PNP transistor 

1 TIP29/D44C4 NPN transistor 

1 TIP30/D45C4 PNP transistor 

1 7805 positive 5V regulator 

1 7812 positive 12V regulator 

1 7912 negative 12V regulator 

1 LM201 high speed operational amplifier 

4 LM1458 dual operational amplifier 

3 1489 quad RS232 receiver/buffer 

2 74LS00 quad 2-input NAND gate IC 

4 74LS04 hex inverter IC 

1 7406 hex open collector inverter/buffer IC 

1 74LS32 quad 2-input OR gate IC 

2 74LS74 dual D-type flip-flop IC 

1 74LS75 quad dual rail transparent latch IC 

2 74LS90 decade counter IC 

1 74LS12 5 quad tri-state buffer IC 

1 74LS138 1 of 8 decoder ICs 

1 74LS174 hex latch with clear IC 

2 74LS244 octal tri-state buffer IC 

2 74LS266 quad 2-input EXNOR gate IC 
1 74LS273 octal latch with clear IC 

1 74LS367 hex tri-state buffer IC 

3 74LS373 octal transparent latch/buffer IC 

2 8ILS95 octal tri-state buffer IC 

2 8ILS96 octal inverting tri-state buffer IC 
1 8259A programmable interrupt controller IC 

3 8250 programmable UART with baud rate generator IC 
1 1990 programmable real-time clock IC 

1 761132x8 bi-polar PROM 
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buffered mode, 9 
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Call instruction, 
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DIP switch 7C, 3 
divisor constant, 22 
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E 

edge -mode, 8 
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